Page 1 of 7
zen-content System Requirements Document
0. Application Specification
1. Introduction
The purpose of this document is to outline the system requirements for the zen-content project, an AI-powered content psychology analyzer designed for social media creators. This document will provide a comprehensive overview of the system's functionality, user personas, visual design, and technical specifications.
2. System Overview
The zen-content platform is a SaaS web application that allows social media creators to analyze the psychological elements of their content. By uploading videos, images, or thumbnails, or by pasting URLs, users can receive insights into why their content might go viral or fail, along with specific recommendations for improvement. The system leverages AI technology to provide these analyses and supports various user roles and subscription plans.
2. Pages / Screens
Page 2 of 7
3. Functional Requirements
- As a Content Creator, I should be able to upload videos, images, or thumbnails for analysis.
- As a Content Creator, I should be able to paste URLs for content analysis.
- As a User, I should receive a detailed report explaining the psychological elements of my content.
- As a User, I should be able to view specific recommendations for improving my content's virality.
- As a User, I should be able to access different features based on my subscription plan.
- As a User, I should be able to manage my profile and subscription details.
- As a User, I should be able to view my analysis history and credit usage.
- As an Admin, I should be able to manage user accounts and subscription plans.
Landing Page
- Theme: Dark purple
- Logo: Brain + Play
- Tagline: "Know Why Your Content Goes Viral"
- Navigation: Sidebar on the left
- Feature: Pricing cards in a row
Dashboard
- Sidebar: Left, active purple
- Stats: 4 cards
- Quick Actions: 4 buttons
- Recent Analyses: List
- AI Chat: Right panel
- Free Plan: Daily Credits section
Page 3 of 7
Pricing
- Plans:
- FREE PLAN: $0
- Creator: $5
- Pro: $15
- PRO MOST POPULAR: $29 (highlighted)
- Business: $50
- Enterprise: Custom
Upload
- Tab: Upload active
- Feature: Drag and drop zone
- Panel: Selected File on the right
- Content Type: Video/Image
- Analysis Mode: Basic/Deep
- Credit Cost: Shown
- Button: Analyze Now (purple)
Analysis Report
- Score: Circle 85/100
- Tabs: Overview, Hook, Retention, Psychology, Content, Audience, Recommendation
- Graph: Retention with drop point
- Score Breakdown: Bars
- Lists: What's Working, Needs Improvement
Page 4 of 7
AI Chat
- Interface: Clean chat
- User Message: Right, purple
- AI Response: Left
- Suggestions: 3 fix suggestions below
- Buttons: Fix my hook, Improve retention, Make it viral
Settings
- Tab: Profile active
- Tabs: Profile, Billing, Credits, Notifications, Security, API
- Sections: Profile info, Plan info
- Credits: 10/10 with timer
- Payment History: Shown
- Legal Links: Right side
- Button: Log Out (red)
4. User Personas
- Content Creator: The primary user of the platform, interested in optimizing their social media content for virality.
- Admin: Responsible for managing user accounts, subscription plans, and overseeing platform operations.
Page 5 of 7
5. Visuals Colors and Theme
The following color palette is designed specifically for the zen-content project:
- primary: #7c3aed (Purple)
- primary_light: #b794f4 (Light Purple)
- secondary: #06b6d4 (Cyan)
- accent: #f59e0b (Yellow)
- highlight: #ef4444 (Red)
- bg: #0a0a1a (Dark Background)
- surface: rgba(26, 26, 58, 0.8) (Card Background)
- text: #ffffff (White)
- text_muted: #94a3b8 (Gray)
- border: rgba(45, 45, 90, 0.2) (Subtle Border)
6. Signature Design Concept
The zen-content homepage will feature an interactive "Content Galaxy" concept. Users will navigate a 3D galaxy where each star represents a different content analysis feature. Using @react-three/fiber and @react-three/drei, users can click on stars to open feature details, drag to rotate the galaxy, and hover to highlight connections between features. This immersive experience will make exploring the platform's capabilities engaging and memorable.
Page 6 of 7
7. Interaction Model & Motion Direction
The landing page will utilize a "parallax" interaction model, creating a layered depth effect as users scroll. Decorative elements, such as atmospheric blobs and distant shapes, will move at different speeds, enhancing the storytelling aspect. Internal pages, such as the dashboard and settings, will follow a "static" interaction model for clarity and ease of use.
8. Non-Functional Requirements
- The system must support high availability and scalability to accommodate a growing user base.
- The platform should ensure data security and user privacy, complying with relevant regulations.
- The application should be responsive and perform optimally across various devices and screen sizes.
9. Tech Stack
- Frontend: React + Vite, Tailwind CSS
- Backend: Supabase (auth and database)
- File Upload: Cloudinary
- AI: OpenAI GPT-4o Vision
- Video Processing: HTML5 Canvas
- Routing: React Router DOM
- Graphs: Recharts
- Icons: Lucide React
- Payment: Razorpay (UI ready, disabled)
Page 7 of 7
9.1 Environment Variables
- OpenAI API: VITE_OPENAI_API_KEY
- Supabase: VITE_SUPABASE_URL, VITE_SUPABASE_ANON_KEY
- Cloudinary: VITE_CLOUDINARY_CLOUD_NAME, VITE_CLOUDINARY_UPLOAD_PRESET
- Razorpay: VITE_RAZORPAY_KEY_ID
10. Assumptions and Constraints
- The platform will initially target content creators in India, with potential expansion to other regions.
- The UI design must match the provided design image exactly.
- The application will operate in demo mode with mock data if environment variables are not set.
11. Glossary
- AI: Artificial Intelligence
- SaaS: Software as a Service
- UI: User Interface
- API: Application Programming Interface
- RLS: Row-Level Security
This document provides a comprehensive overview of the zen-content project, ensuring that all stakeholders have a clear understanding of the system's requirements and design.
No comments yet. Be the first!