System Requirements Document (SRD)

purple-videos

1. Introduction

purple-videos is a web application designed to empower users in Pakistan and beyond to effortlessly create automated short-form videos without requiring any editing skills. Inspired by platforms like FacelessReels.com, purple-videos aims to provide a simple, beginner-friendly experience for generating faceless videos tailored to various content categories. The platform will integrate AI-driven automation to handle scriptwriting, voiceovers, visuals, animations, subtitles, and social media scheduling, ensuring a seamless and fully automated workflow for creators.

This document outlines the system requirements for purple-videos, ensuring alignment with Rayyan Ali's vision of a free-to-use, accessible, and highly optimized platform for vertical video creation.

2. System Overview

purple-videos will be a fully automated web application that allows users to:

• Sign up and log in for free.
• Enter a topic or idea to generate faceless short-form videos.
• Select from predefined content categories such as horror, funny, history, storytelling, motivation, or educational content.
• Automatically generate videos with AI-driven scripts, voiceovers, visuals, animations, and subtitles.
• Connect social media accounts (YouTube, TikTok, Instagram) for automated posting.
• Schedule video uploads by specifying the number of videos per day and the time of posting.
• Access a dashboard to track generated videos, scheduled posts, and their status (processing or posted).

The platform will prioritize simplicity, speed, and automation, ensuring users can focus solely on their ideas while the system handles all technical aspects.

3. Functional Requirements

• As a User, I should be able to sign up and log in for free to access the platform.
• As a User, I should be able to enter a topic or idea to generate a faceless short-form video.
• As a User, I should be able to choose from content categories like horror, funny, history, storytelling, motivation, or educational content.
• As a User, I should be able to connect my social media accounts (YouTube, TikTok, Instagram) to the platform.
• As a User, I should be able to schedule video uploads by specifying the number of videos per day and the time of posting.
• As a User, I should be able to view a dashboard displaying my generated videos, scheduled posts, and their status (processing or posted).
• As a User, I should be able to generate videos that include AI-driven scripts, voiceovers, visuals, animations, and subtitles automatically.
• As a User, I should be able to access all features without encountering paywalls, subscriptions, or locked functionalities.

4. User Personas

Admin

• Manages user accounts and monitors system performance.
• Ensures the platform remains free and accessible.
• Oversees AI model updates and content moderation.

User

• Primary audience for the platform.
• Creates faceless videos by entering topics and selecting content categories.
• Connects social media accounts for automated posting.
• Tracks video generation and posting status via the dashboard.

5. Visuals Colors and Theme

Color Palette

• primary: #6A1B9A (Deep Purple)
• primary_light: #AB47BC (Light Purple for hover states)
• secondary: #FF7043 (Coral Orange for emphasis and links)
• accent: #29B6F6 (Sky Blue for CTAs and badges)
• highlight: #FFD54F (Amber for notifications and active indicators)
• bg: #F3E5F5 (Soft Lavender for page background)
• surface: rgba(106, 27, 154, 0.8) (Semi-transparent purple for cards/panels)
• text: #212121 (Dark Gray for primary text)
• text_muted: #757575 (Muted Gray for secondary text and timestamps)
• border: rgba(106, 27, 154, 0.2) (Subtle purple for borders)

6. Signature Design Concept

Interactive Video Carousel Landing Page

The homepage will feature a dynamic, interactive carousel showcasing sample videos from different content categories (horror, funny, history, storytelling, motivation, educational). Users can hover over each category to preview a short animation of the video style, with subtle transitions like zoom-ins, fade-ins, and text overlays.

Key features:

• Hover Interaction: Hovering over a category will display a looping preview animation of a sample video.
• Click-to-Explore: Clicking a category will expand it into a full-screen modal with details about the video generation process and a "Start Creating" button.
• Dynamic Background: The background will subtly shift colors based on the selected category (e.g., dark red for horror, bright yellow for funny).
• Micro-Interactions: Buttons and links will have spring physics animations using framer-motion.
• Library Recommendations: Use gsap for scroll-triggered animations and framer-motion for hover effects and modal transitions.

This concept will make the landing page visually captivating and highly interactive, leaving a lasting impression on users.

7. Interaction Model & Motion Direction

Landing Page Interaction Model: Parallax

The homepage will use a parallax interaction model to create layered depth. Atmospheric elements like floating particles, subtle gradients, and category icons will move at different speeds as users scroll. Real content will remain in normal flow for easy navigation.

Internal Pages Interaction Model: Static

Dashboard, settings, and profile pages will prioritize clarity and simplicity with minimal motion.

Distinctive Section Mechanics:

• Category Showcase: Scroll-triggered zoom and fade animations for category previews.
• Video Generation Flow: Step-by-step narrative with kinetic typography and morphing SVG icons.
• Social Media Integration: Cursor-reactive tilt effects for social media icons.

8. Non-Functional Requirements

• The system must support high-speed video generation optimized for vertical formats.
• The platform must handle concurrent user requests efficiently without performance degradation.
• The system must ensure data security for user accounts and social media integrations.
• The platform must be accessible across devices and browsers.

9. Tech Stack

Frontend

• React for Web

Backend

• Python
• FastAPI

Database

• MySQL or MariaDB (RDBMS)

AI Models

• GPT 5.4 for script generation and user-friendly responses
• Google Nano Banana for image and animation generation

AI Tools

• Langchain for AI workflow orchestration

Local Orchestration

• Docker
• docker-compose

Server-Side Orchestration

• Kubernetes

10. Assumptions and Constraints

• The platform will remain free to use, with no paywalls or subscriptions.
• Users will not require advanced technical skills to operate the system.
• The system will prioritize vertical video formats optimized for social media platforms.
• Social media APIs will support automated posting functionality.

11. Glossary

• Faceless Videos: Videos that do not feature human faces, relying on animations, text, and voiceovers instead.
• Vertical Format: A video aspect ratio optimized for mobile viewing (e.g., 9:16).
• AI Models: Artificial intelligence systems used for automating video creation tasks.
• Dashboard: A user interface for tracking generated videos and scheduled posts.