System Requirements Document for Gilded-One

1. Introduction

Gilded-One is a tool designed to transform long videos and podcasts into ready-to-post Shorts, Reels, and TikToks. It automates the process of creating platform-optimized edits with captions, hooks, and other enhancements, catering to the needs of content creators who wish to streamline their workflow and maximize their reach on social media platforms.

2. System Overview

Gilded-One aims to provide a seamless experience for content creators by automating the editing process for short-form content. The system leverages AI to identify key moments in videos and podcasts, generates vertical clips with captions, and offers direct publishing capabilities to major social media platforms.

3. Functional Requirements as Story Points

• As a Creator, I should be able to upload a YouTube video or podcast audio to the platform.
• As a Creator, I want the AI to automatically select the best 5–10 “viral-worthy” moments based on transcript, energy, and topics.
• As a Creator, I want the system to auto-generate vertical 9:16 clips with safe margins for TikTok, Instagram, and YouTube.
• As a Creator, I want burned-in captions in trendy styles to be automatically added to my clips.
• As a Creator, I want the system to provide 3 hook/title options per clip.
• As a Creator, I want to be able to export clips with one click or directly publish them to TikTok, Instagram, and YouTube via API.
• As a Creator, I want a simple library to track the status of each clip as “Used,” “Scheduled,” or “Posted.”
• As a Creator, I want to choose from different pricing plans based on my usage needs.

4. User Personas

• Creator: A content creator who produces long-form videos or podcasts and wants to convert them into short-form content for social media platforms.

5. Core User Flows

1. Creator uploads a video or podcast.
2. AI analyzes the content and selects key moments.
3. System generates vertical clips with captions and hook options.
4. Creator reviews and selects preferred hooks/titles.
5. Creator exports clips or publishes directly to social media.
6. Creator manages clip statuses in the library.

6. Visuals Colors and Theme

• primary: #FF5733 (a vibrant orange to reflect creativity and energy)
• primary_light: #FF8A66 (a lighter tint for hover states)
• secondary: #3333FF (a deep blue for contrast and professionalism)
• accent: #FFC300 (a bright yellow for emphasis on CTAs)
• highlight: #DAF7A6 (a light green for notifications and active states)
• bg: #FFFFFF (a clean white background)
• surface: #F2F2F2 (a light gray for card/panel backgrounds)
• text: #000000 (black for primary text)
• text_muted: #666666 (a muted gray for secondary text)
• border: #CCCCCC (a subtle gray for borders)

7. Signature Design Concept

Interactive Video Editing Canvas

The homepage features an interactive video editing canvas where users can drag and drop video segments to create their ideal short-form content. As users hover over different segments, they see a preview of the clip with animated captions and hook options. This dynamic interface allows creators to visualize their content in real-time, making the editing process intuitive and engaging.

Landing Hero Motion Brief

The landing page showcases a continuous loop of a video being transformed into a short-form clip. The animation begins with a long video file entering the frame, which then splits into smaller segments. Each segment is highlighted with captions and hooks, demonstrating the transformation process. The loop ends with the final short-form clip being published to a social media platform, emphasizing the ease and efficiency of the tool.

8. Interaction Model & Motion Direction

• Interaction Model: Animated
  • The landing page will feature moderate scroll-triggered reveals and hover transitions to enhance user engagement.
• Internal Pages: Static
  • Focus on layout clarity and minimal motion for dashboards and settings.

9. Non-Functional Requirements

• The system must ensure data privacy and secure handling of user content.
• The platform should be scalable to accommodate a growing user base.
• The system must provide high availability and reliability.

10. Tech Stack

• Frontend: React for Web
• Backend: Python, FastAPI
• Database: MySQL or MariaDB
• AI Models: GPT 5.4 for user-friendly responses
• AI Tools: Litellm for LLM Routing
• Local Orchestration: Docker, docker-compose
• Server-side Orchestration: Kubernetes

11. Assumptions and Constraints

• The system assumes users have basic knowledge of video editing and social media platforms.
• The platform is constrained by the API limitations of TikTok, Instagram, and YouTube for direct publishing.
• The pricing model is based on the assumption of a tiered subscription service.

12. Glossary

• Shorts/Reels/TikToks: Short-form video content optimized for social media platforms.
• Viral-worthy moments: Key segments of a video or podcast that are likely to engage viewers.
• Burned-in captions: Text captions that are permanently embedded into a video clip.
• API: Application Programming Interface, a set of protocols for building and interacting with software applications.