Turn one idea into a platform-ready video script — hook, timestamps, B-roll, CTA and SEO tags — in seconds.

Try it live · Features · How it works · Run locally · بالعربي

---

💡 Why ScriptForge

Blank page → filmable script. ScriptForge structures your idea the way short-form and long-form creators actually shoot: a scroll-stopping hook first, timed sections with visual direction, then a clear call to action.

• Made for each platform — pacing and length adapt to YouTube, TikTok, Reels, online courses and webinars.
• Script to video — turn the finished script into a detailed, scene-by-scene prompt for AI video tools.
• Open to everyone — no account, no paywall, full English & Arabic (RTL) support.

---

✨ Features

🎬 Script generator Title options, a typed hook, timestamped sections with dialogue, visual direction and B-roll, a CTA, SEO tags and retention notes.	🎥 Video prompt builder Edit the hook and script, then build a production-ready prompt for text-to-video models — copy it in one click.	🧭 Idea gallery Dribbble-style starter ideas with platform mockups. Filter by platform; one click fills the whole form.
📎 Bring your sources Add a video link, paste an article or transcript, or upload an image to ground the script.	🌍 English · العربية Generate in English, Arabic or both. The interface switches to a native right-to-left layout.	🌗 Light & dark A clean white/ink/pink design system with semantic tokens, responsive down to small phones.

Controls you get: platform (YouTube · TikTok · Reels · Course · Webinar) · duration (30s → 15+ min) · tone (educational, entertaining, dramatic, casual, motivational) · target audience · key message.

---

🧠 How it works

flowchart LR
    A([💡 Idea or<br/>gallery pick]) --> B[Script parameters<br/>platform · duration · tone<br/>audience · sources]
    B -->|Generate| C{{generate-script<br/>Edge Function}}
    C --> D[📄 Script output<br/>hook · timed sections · CTA · SEO]
    D --> E[🎥 Video prompt builder]
    E -->|Build prompt| F{{enhance-prompt<br/>Edge Function}}
    F --> G([📋 Detailed video prompt])

    classDef pink fill:#EA4C89,stroke:#C2185B,color:#fff
    classDef ink fill:#0D0C22,stroke:#0D0C22,color:#fff
    class C,F pink
    class A,G ink

Loading

flowchart TB
    subgraph Browser["🖥️ Browser — React 18 + Vite SPA"]
        UI[Hero · Idea gallery · Script form]
        OUT[Script output · Video prompt builder]
        SET[Theme + language settings<br/>localStorage]
    end
    subgraph Supabase["⚡ Supabase"]
        GS[generate-script]
        EP[enhance-prompt]
    end
    AI[(🤖 Groq · OpenRouter · Lovable<br/>automatic fallback)]

    UI -- supabase.functions.invoke --> GS
    OUT -- supabase.functions.invoke --> EP
    GS --> AI
    EP --> AI
    GS -- structured JSON --> OUT

Loading

---

📸 Screenshots

Hero & search — light	Idea gallery — dark
Support dialog	Mobile — Arabic (RTL)

---

🛠️ Tech stack

Layer	Tools
UI	React 18, TypeScript, Vite, Tailwind CSS, shadcn/ui (Radix), Framer Motion, Lucide icons
Backend	Supabase Edge Functions (Deno): generate-script, enhance-prompt
AI	Open-weight models via Groq (openai/gpt-oss-120b, free tier) → OpenRouter free models → Lovable AI Gateway, with automatic fallback
Quality	ESLint, Vitest, Testing Library, Playwright
Hosting	Lovable

---

🚀 Run it locally

Requirements: Node.js 18+ and npm (or Bun), plus a Supabase project for the edge functions.

git clone https://github.com/3h0ll7/scriptforge-ai.git
cd scriptforge-ai
cp .env.example .env      # fill in your Supabase URL + publishable key
npm install
npm run dev               # http://localhost:8080

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

Deploying the edge functions

npx supabase link --project-ref your-project-ref
npx supabase db push
npx supabase functions deploy generate-script
npx supabase functions deploy enhance-prompt

Both functions share supabase/functions/_shared/ai.ts, which tries each configured provider in order and moves on when one is out of credits, rate-limited or has retired a model. Set at least one key as a Supabase secret — never in .env or in git:

Secret	Provider	Default models (strongest first)
GROQ_API_KEY	Groq — free tier	openai/gpt-oss-120b, openai/gpt-oss-20b; images: qwen/qwen3.8-27b → llama-4-scout
OPENROUTER_API_KEY	OpenRouter — free models	openai/gpt-oss-120b:free, deepseek/deepseek-chat-v3.1:free
LOVABLE_API_KEY	Lovable AI Gateway (paid credits)	google/gemini-3-flash-preview

Override any model list with comma-separated GROQ_MODELS, GROQ_VISION_MODELS, OPENROUTER_MODELS or OPENROUTER_VISION_MODELS.

npx supabase secrets set GROQ_API_KEY=your-groq-key

Command	What it does
npm run dev	Start the dev server on port 8080
npm run build	Production build into dist/
npm run preview	Serve the production build
npm run lint	ESLint
npm test	Vitest

---

📁 Project structure

scriptforge-ai/
├── docs/                       # README banner, demo GIF, screenshots
├── public/                     # Static assets
├── src/
│   ├── components/
│   │   ├── IdeaGallery.tsx     # Filterable starter ideas
│   │   ├── IdeaShot.tsx        # Platform mockup thumbnails
│   │   ├── ScriptForm.tsx      # Script parameters (accepts presets)
│   │   ├── ScriptOutput.tsx    # Generated script view
│   │   ├── VideoPromptBuilder.tsx
│   │   ├── SupportDialog.tsx   # USDT donation dialog
│   │   └── ui/                 # shadcn/ui primitives
│   ├── hooks/useAppSettings.tsx # Theme, language, EN/AR strings
│   ├── lib/                    # generateScript, idea templates, donation config
│   ├── pages/Index.tsx         # Hero · gallery · workspace
│   └── index.css               # Design tokens (light/dark)
├── supabase/
│   ├── functions/              # Edge functions
│   └── migrations/
└── AGENTS.md                   # Architecture rules for contributors & agents

---

🗺️ Roadmap

• Script generation for YouTube, TikTok, Reels, courses & webinars
• Video prompt builder
• English & Arabic with RTL
• Dribbble-inspired redesign, idea gallery, dark mode
• Free public access, optional donations
• Save & export scripts (PDF / Markdown)
• More idea templates and niches
• Shareable script links
• Voice-over generation

---

❤️ Support the project

ScriptForge is free. If it saves you time, you can send a tip in USDT on BNB Smart Chain (BEP20):

0x03d28429e4c9a0ae0d6fcc750ac4b1cf0bd41850

⚠️ Send only USDT on BEP20. Other coins or networks (TRC20, ERC20…) will be lost.

---

🇮🇶 بالعربي

اضغط لعرض الوصف بالعربي

ScriptForge AI

حوّل فكرة واحدة إلى سكربت فيديو جاهز للتصوير خلال ثوانٍ: خطّاف (Hook) يوقف التمرير، أقسام بتوقيت زمني مع توجيه بصري ولقطات B-roll، دعوة للعمل، ووسوم SEO.

المميزات

• سكربتات مخصّصة لـ YouTube و TikTok و Reels والدورات والندوات.
• مُنشئ برومبت فيديو مفصّل مشهداً بمشهد لأدوات توليد الفيديو بالذكاء الاصطناعي.
• معرض أفكار جاهزة يملأ النموذج بضغطة واحدة.
• إرفاق رابط فيديو أو نص أو صورة كمصدر.
• واجهة عربية كاملة من اليمين لليسار، ووضع فاتح وداكن.
• مجاني بالكامل وبدون تسجيل دخول.

التشغيل محلياً

git clone https://github.com/3h0ll7/scriptforge-ai.git
cd scriptforge-ai && cp .env.example .env && npm install && npm run dev

ادعم المشروع: USDT على شبكة BEP20 فقط — العنوان موجود في قسم Support the project أعلاه.

---

🤝 Contributing

Issues and pull requests are welcome. Please read AGENTS.md for the architecture rules, keep changes small, and run npm run lint && npm test && npm run build before opening a PR.

📜 License

No license file has been added yet, so all rights are reserved by the author by default.

---

Built by Hassan Salman with Lovable, Supabase and shadcn/ui.