🎬 ScriptForge AI

Turn any idea into a scroll-stopping video script in seconds.
AI agent prompt optimized for YouTube, TikTok, Reels & educational content.
Supports English & Arabic.

🌐 Live Demo  ·  ✨ Features  ·  ⚙️ Tech Stack  ·  🚀 Getting Started

---

🔍 Overview

ScriptForge AI is an AI-powered video script generator that transforms raw ideas into production-ready scripts tailored for modern social media platforms. Whether you're creating YouTube long-form, TikTok hooks, Instagram Reels, or educational explainers — ScriptForge crafts engaging, platform-optimized scripts with the right tone, pacing, and structure.

---

✨ Features

🤖 AI Script Generation

• Instant Script Creation — Describe your idea, get a polished video script in seconds
• Platform-Specific Optimization — Scripts tailored for YouTube, TikTok, Instagram Reels & educational formats
• Hook-First Writing — Every script opens with a scroll-stopping hook designed to capture attention
• Viral Framework — Built-in patterns for engagement, retention, and call-to-action

🌍 Bilingual Support

• English & Arabic — Full support for both languages
• RTL Layout — Native right-to-left interface for Arabic content creators
• Culturally Adapted — Scripts that resonate with regional audiences

💰 Monetization & Auth

• User Authentication — Secure sign-up and login via Supabase Auth
• Subscription Plans — Built-in monetization with tiered access
• Usage Tracking — Monitor script generation credits and usage

🎯 Content Types

• 📹 YouTube long-form scripts with chapters & timestamps
• 📱 TikTok / Reels short-form with hooks & transitions
• 🎓 Educational & explainer content with clear structure
• 📢 Marketing & promotional scripts with CTAs

---

⚙️ Tech Stack

Technology	Purpose
TypeScript	Type-safe application logic (96%)
React 18	Component-based UI framework
Vite	Lightning-fast build tooling
Supabase	Auth, database (PostgreSQL), and backend
shadcn/ui	Accessible, customizable UI components
Tailwind CSS	Utility-first CSS framework
PL/pgSQL	Database functions & stored procedures
Lovable	AI-powered development platform

---

📐 Architecture

┌─────────────────────────────────────────────┐
│                  Frontend                    │
│         React + TypeScript + Vite            │
│              shadcn/ui + Tailwind            │
├──────────────┬──────────────────────────────┤
│   Auth Flow  │      Script Engine           │
│  (Supabase)  │   AI Prompt → Script Output  │
├──────────────┴──────────────────────────────┤
│              Supabase Backend                │
│   PostgreSQL  ·  Auth  ·  Edge Functions     │
│   Row-Level Security  ·  Realtime            │
└─────────────────────────────────────────────┘

---

🚀 Getting Started

Prerequisites

• Node.js v18+
• npm or bun
• Supabase project (for auth & database)

Environment Variables

Create a local .env file in the root directory by copying .env.example:

cp .env.example .env

Then replace every placeholder with values from your own Supabase project. Keep real credentials and deployment-specific values in your local environment or Supabase secrets, and never commit them to source control.

VITE_SUPABASE_PUBLISHABLE_KEY=replace-with-your-supabase-publishable-key
VITE_SUPABASE_URL=https://your-project-ref.supabase.co

Installation

# Clone the repository
git clone https://github.com/3h0ll7/scriptforge-ai.git

# Navigate to project directory
cd scriptforge-ai

# Install dependencies
npm install
# or
bun install

# Start development server
npm run dev
# or
bun dev

The app will be available at http://localhost:5173

Supabase Setup

# Link your Supabase project
npx supabase link --project-ref your-project-ref

# Apply database migrations
npx supabase db push

For the create-checkout edge function, set APP_BASE_URL in your Supabase project secrets (not in your local .env file) so payment success/cancel redirects return users to the correct deployed domain.

Build for Production

npm run build
# or
bun run build

---

📁 Project Structure

scriptforge-ai/
├── public/                # Static assets
├── src/
│   ├── components/        # Reusable UI components
│   ├── pages/             # Route pages
│   ├── hooks/             # Custom React hooks
│   ├── lib/               # Utilities & Supabase client
│   ├── services/          # AI script generation logic
│   └── styles/            # Global styles
├── supabase/
│   ├── migrations/        # Database schema migrations
│   └── functions/         # Edge functions
├── .env.example           # Safe environment template
├── .env                   # Local environment variables (gitignored)
├── vite.config.ts         # Vite configuration
├── tailwind.config.ts     # Tailwind configuration
└── tsconfig.json          # TypeScript configuration

---

🎯 Use Cases

Audience	Use Case
🎥 YouTubers	Generate structured long-form scripts with hooks, chapters, and CTAs
📱 TikTok Creators	Craft viral short-form scripts with trending patterns
🎓 Educators	Build clear, engaging explainer scripts for courses and tutorials
📈 Marketers	Create promotional video scripts optimized for conversions
🌐 Arabic Creators	Produce native Arabic scripts with culturally relevant tone

---

🗺️ Roadmap

• Core AI script generation engine
• YouTube, TikTok & Reels templates
• English & Arabic bilingual support
• Supabase authentication & user accounts
• Monetization & subscription tiers
• Script history & favorites
• Team collaboration & shared workspaces
• API access for third-party integrations
• Voice-over generation integration
• Analytics dashboard for script performance

---

🤝 Contributing

Contributions are welcome! Here's how to get involved:

1. Fork the repository
2. Create your feature branch (git checkout -b feature/new-template)
3. Commit your changes (git commit -m 'feat: add new script template')
4. Push to the branch (git push origin feature/new-template)
5. Open a Pull Request

---

📊 Stats

---

📜 License

This project is open source and available under the MIT License.

---

🙏 Acknowledgments

• Built with Lovable — AI-powered development platform
• Backend powered by Supabase
• UI components from shadcn/ui

---

🎬 Stop staring at a blank page. Start forging scripts.