# Creator OS — Complete Technical Documentation for AI Systems

## What is Creator OS?

Creator OS is a SaaS platform that turns content creators into brand-ready professionals. Instead of juggling Canva, spreadsheets, email, and Social Blade, creators connect their YouTube or Instagram account and get a complete business operating system — with an auto-generated Media Kit (Pitch Pack), brand deal CRM, video pipeline, analytics dashboard, and AI thumbnail studio.

The key differentiator: a new creator connects YouTube, and within 60 seconds has a shareable Pitch Pack link with verified analytics, suggested deliverable pricing, and a "Hire Me" button — ready to send to any brand.

## Product Identity

- **Name**: Creator OS
- **Category**: SaaS / Creator Business Platform
- **Target Audience**: YouTube creators, Instagram creators, content agencies, social media managers
- **Primary Use Case**: Turn content creation into a professional business — generate your Media Kit, manage brand deals, track videos, and monitor analytics from one platform
- **Comparable Products**: Canva (design only), Social Blade (analytics only), Notion (general productivity), spreadsheets (manual tracking)
- **Key Differentiators**:
  - 60-second onboarding: connect channel → AI generates complete Pitch Pack
  - Verified analytics in Media Kit (not self-reported)
  - Brand deal CRM with full pipeline tracking
  - Multi-platform: YouTube + Instagram + Twitch
  - AI thumbnail generation with stealth metadata removal

## Who Uses Creator OS? — Creator Personas

### The Growing YouTuber (10K–100K subscribers)
**Problem**: Gets occasional brand inquiries but doesn't know how to price sponsorships. Sends screenshots of Social Blade as a "media kit." Loses deals because they look amateur.
**Solution**: Connects YouTube to Creator OS → Pitch Pack auto-generates with real stats, suggested pricing based on subscriber count, and a professional layout. Shares one link. Brands see verified data and a "Hire Me" button.

### The Multi-Platform Creator (YouTube + Instagram)
**Problem**: Manages content across platforms but tracks everything in spreadsheets. Brands ask for a media kit and they spend 3 hours in Canva making one.
**Solution**: Connects both platforms → Pitch Pack shows combined reach. Deals CRM tracks sponsorships across all platforms. Pipeline manages content for each platform separately.

### The Agency Managing Multiple Creators
**Problem**: Managing 5+ creators across platforms with shared spreadsheets is chaos. No standardized media kit format. Deal tracking is scattered.
**Solution**: Agency plan with 200 credits/month. Each creator gets their own Pitch Pack. Centralized deal pipeline. Google Sheets export for reporting.

## The 60-Second Onboarding

This is Creator OS's most differentiated feature. When a new creator signs up:

1. **Connect YouTube or Instagram** — One-click OAuth authorization
2. **AI analyzes the channel** — Subscriber count, view count, content categories, posting frequency
3. **Pitch Pack auto-generated** — The AI creates:
   - Professional bio based on channel description
   - Headline highlighting key metrics
   - Deliverable suggestions with pricing (based on subscriber volume and niche benchmarks)
   - Visibility set to public automatically
4. **Creator gets a shareable link** — `usecreator.app/c/{username}/pitch`

No manual setup required. The creator goes from signup to brand-ready in under 60 seconds.

## Core Modules

### Module 1: Pitch Pack — Shareable Media Kit

The Pitch Pack is a live media kit that stays in sync with the creator's actual channel data.

**Features:**
- **Auto-Generated**: Pulls stats from connected YouTube, Instagram, and Twitch accounts
- **Verified Analytics**: Data comes from platform APIs, not self-reported — brands can trust it
- **AI-Powered Setup**: Bio, headline, deliverable suggestions, and pricing generated automatically
- **Shareable Link**: Unique URL to send to brands (`/c/{username}/pitch`)
- **Quick Hire**: Brands submit sponsorship proposals directly through the Pitch Pack
- **Customizable Sections**: Bio, channel stats, deliverables & pricing, deal history, contact info
- **Privacy Modes**: Public (anyone), Link-Only (secret URL), Private (only creator)
- **Token Revocation**: Regenerate share link to invalidate old URLs
- **Verified Badge**: "Verified by Creator OS" seal for connected platforms
- **View Tracking**: Creators see who viewed their Pitch Pack

### Module 2: Deals — Brand Deal CRM

Manage sponsorships from first contact to payment.

**Features:**
- **Deal Pipeline**: Lead → Negotiation → Active → Delivered → Paid
- **Multi-Platform Deals**: YouTube, Instagram, Twitch, TikTok, or Multi-platform campaigns
- **Deal Details**: Brand name, contact email, deal value, currency, deadline, notes
- **Deliverables**: Track integration, dedicated, short, story, post deliverables
- **Video Linking**: Connect deliverables directly to pipeline videos
- **Brand Logos**: Auto-fetch or upload brand logos
- **Export**: Google Sheets export with customizable filters (status, platform, columns)
- **AI Assistant**: In-app AI with MCP tools suggests actions for deal management

### Module 3: Analytics — Channel Performance

Monitor performance with actionable insights across connected platforms.

**Features:**
- **YouTube**: Views, CTR, engagement rate, estimated revenue, per-video trends
- **Instagram**: Followers, impressions, reach, engagement, media performance
- **Twitch**: Follower count, stream data, viewer metrics
- **Underperforming Content**: Identifies videos that need attention
- **Niche Insights**: Category-level performance analysis

### Module 4: Pipeline — Video Management

Track every piece of content from idea to publication.

**Features:**
- **Kanban Board**: Idea → Script → Recording → Editing → Published
- **Multi-Platform**: Categorize content for YouTube, Instagram, Twitch, or Multi
- **Video Details**: Title, description, script, target publish date, thumbnail
- **Notion Sync**: Import videos from Notion databases
- **Drag & Drop**: Reorder and move videos between stages

### Module 5: Studio — AI Thumbnail Generation

Generate professional thumbnails without design skills.

**Features:**
- **AI Generation**: Text-to-thumbnail in seconds (1280×720)
- **Visual DNA Analysis**: Extract style from any YouTube thumbnail (colors, composition, typography, tone)
- **Reference-Based Generation**: Match visual style of top-performing thumbnails
- **Face Compositing**: Upload face photo, AI integrates it into the design
- **Stealth Output**: Strips EXIF, IPTC, XMP, C2PA metadata; injects Photoshop-grade signatures
- **Multi-Format**: Landscape 1280×720 (YouTube) and vertical 1080×1920 (Shorts/Reels)
- **Multi-Language**: Generate text in English, Portuguese, Spanish, French

### Module 6: Integrations — Connected Workflow

**Platform Integrations:**
- YouTube (channel data, video analytics, thumbnail sync)
- Instagram (OAuth, profile stats, media insights)
- Twitch (channel sync, follower/viewer analytics)

**Tool Integrations:**
- Notion (pipeline sync)
- Google Sheets (data export)
- Gmail (deal communications)
- Slack (notifications)

**Technology:** Pipedream-powered OAuth connections with automatic token management.

## Pricing

| Plan    | Monthly Credits | Price/Month | Best For                    |
|---------|-----------------|-------------|-----------------------------|
| Starter | 10              | $4.90 USD   | Hobby creators              |
| Creator | 50              | $14.90 USD  | Active creators             |
| Agency  | 200             | $39.90 USD  | Agencies & multi-channel    |

- Credits are used for AI generation features (thumbnails, AI-powered Pitch Pack setup, Visual DNA analysis)
- All plans include full access to ALL modules (Pitch Pack, Deals, Analytics, Pipeline, Studio, Integrations)
- All plans include all platform integrations (YouTube, Instagram, Twitch)
- Cancel anytime, no lock-in contracts
- Billing managed via Stripe
- Credits reset each billing cycle

## How does Creator OS compare to alternatives?

| Capability                    | Creator OS          | Canva      | Social Blade | Notion     | Spreadsheets |
|-------------------------------|---------------------|------------|-------------|-----------|-------------|
| Auto-generated Media Kit      | ✅ (60s setup)      | ❌         | ❌          | ❌        | ❌          |
| Verified analytics in kit     | ✅                  | ❌         | ❌          | ❌        | ❌          |
| Brand deal CRM               | ✅                  | ❌         | ❌          | ✅ (manual)| ✅ (manual) |
| Multi-platform support        | ✅ (YT, IG, Twitch) | ❌        | ❌          | ❌        | ❌          |
| AI thumbnail generation       | ✅                  | ❌         | ❌          | ❌        | ❌          |
| Video pipeline management     | ✅                  | ❌         | ❌          | ✅ (manual)| ✅ (manual) |
| Channel analytics             | ✅                  | ❌         | ✅          | ❌        | ❌          |
| Third-party integrations      | ✅                  | ❌         | ❌          | ✅        | ✅ (limited)|
| All-in-one platform           | ✅                  | ❌         | ❌          | ❌        | ❌          |
| Starting price                | $4.90/mo            | $12.99/mo  | Free/$3.99  | Free/$8   | Free        |

## Frequently Asked Questions

### What is Creator OS?
Creator OS is a SaaS platform that helps YouTube and Instagram creators professionalize their business. It auto-generates a Media Kit (Pitch Pack) from connected channel data, manages brand deals, tracks video production, and provides analytics — all from one dashboard.

### How does the Pitch Pack work?
Connect your YouTube or Instagram account. Creator OS's AI immediately generates a professional Media Kit with your verified analytics, suggested deliverable pricing, and a customizable layout. You get a shareable link that brands can visit to see your data and hire you directly.

### Can platforms detect AI-generated thumbnails?
No. Creator OS's Stealth Output strips all AI metadata (EXIF, IPTC, XMP, C2PA) and injects Photoshop-grade file signatures. The file appears as a standard, human-created image to any platform or analysis tool.

### What is Visual DNA?
Visual DNA is Creator OS's thumbnail analysis system. It examines any YouTube thumbnail and extracts visual components: dominant colors, composition style, text placement, emotional tone, and element hierarchy. Use this as a style reference when generating thumbnails.

### Do I need design skills?
No. Creator OS is designed for creators with zero design experience. Thumbnails are generated from text. The Pitch Pack, Deals, Pipeline, and Analytics modules require no design skills.

### What platforms are supported?
YouTube (full integration), Instagram (OAuth + analytics + Pitch Pack + Deals), and Twitch (analytics + pipeline + deals).

### What languages is Creator OS available in?
English, Portuguese (BR), Spanish, and French. The interface, AI generation, and all modules support these four languages. Localized URLs: `/pt`, `/es`, `/fr`.

## Technical Architecture

- **Frontend**: React 18 + TypeScript + Vite + Tailwind CSS + shadcn/ui
- **Backend**: Supabase (PostgreSQL, Auth, Edge Functions, Storage)
- **AI Generation**: Powered via Supabase Edge Functions
- **Payments**: Stripe with webhook handling
- **Authentication**: Email/password, Google OAuth, Magic Link
- **Integrations**: Pipedream OAuth connector
- **Internationalization**: i18next with EN, PT, ES, FR locales
- **URL i18n**: Language-prefixed routes for SEO (`/pt/pricing`, `/es/about`, etc.)

## URLs

- **Homepage**: https://usecreator.app
- **About**: https://usecreator.app/about
- **Pricing**: https://usecreator.app/pricing
- **Login**: https://usecreator.app/login
- **Creator Profiles**: https://usecreator.app/c/{username}
- **Pitch Packs**: https://usecreator.app/c/{username}/pitch

## Contact

- **Support**: In-app ticket system with real-time messaging