Skip to main content

5-Minute Quick Start

git clone <repository-url>
cd scriptonia
npm install
cp env.example .env
Edit .env
  • Set DATABASE_URL (PostgreSQL)
  • Set one AI key:
    • OPENAI_API_KEY
    • OPENROUTER_API_KEY_GROK4
npx prisma migrate dev
npm run dev
Open
http://localhost:3000
You can complete:
  • Idea
  • Intent
  • See Platform options
For Payment → Execution → Completion, add Solana or Dodo
(see Prerequisites Checklist).

Prerequisites Checklist

System
  • Node.js 18+
    node -v
  • npm (or yarn)
    npm -v
  • PostgreSQL
    Local or Supabase, Neon, Railway, etc.
Environment Variables
  • DATABASE_URL
    Connection string in .env
  • OPENAI_API_KEY or OPENROUTER_API_KEY_*
    Required for Idea, Intent, Platform, Execution
    One of:
    • OPENAI_API_KEY
    • OPENROUTER_API_KEY_GROK4
    • OPENROUTER_API_KEY_QWEN3
    • OPENROUTER_API_KEY_GEMINI2_5

Payments (Optional)

Solana (crypto)
  • RPC
  • TREASURY_WALLET
  • SCRIPT_TOKEN_MINT
  • Use NEXT_PUBLIC_SOLANA_NETWORK=devnet for testing
  • Helius or public RPC
Wallet
  • Phantom / AppKit
  • NEXT_PUBLIC_REOWN_PROJECT_ID
Dodo (card / UPI)
  • DODO_API_KEY
  • DODO_WEBHOOK_SECRET
  • DODO_PRODUCT_ID
  • NEXT_PUBLIC_APP_URL
Webhook
https://your-domain/api/dodo/webhook

GitHub (Optional)

  • GITHUB_CLIENT_ID
  • GITHUB_CLIENT_SECRET
  • GITHUB_CALLBACK_URL
Local callback
http://localhost:3000/api/github/callback

Minimal Setup

  • DATABASE_URL
  • One AI key
(Idea → Intent → Platform only)

Full Flow Setup

  • Above
  • Solana or Dodo
(through Completion)

Step-by-Step First Project

1. Idea (/)
  • Enter an idea
    Example: “A todo app for remote teams with assignees and due dates”
  • Submit
AI returns:
  • Analysis
  • Clarifying questions
2. Intent (/intent)
  • Answer the questions in the chat
    Examples:
    • Target users
    • Must-have vs nice-to-have features
  • Submit
AI produces refined requirements:
  • Title
  • Features
  • Audience
  • Tech notes
3. Platform (/platform)
  • Review options:
    • Website
    • Web Application
    • Android
    • iOS
  • Includes cost and timeline
  • Select one
  • Redirected to Payment
4. Payment (/payment) Solana
  • Connect Phantom (or AppKit)
  • Ensure $SCRIPT or SOL (devnet ok for testing)
  • Approve the transfer
  • On success → Execution
Dodo
  • Click “Buy with Card”
  • Complete checkout
  • Redirected to /payment/success
  • Webhook confirms → Execution
5. Execution (/execution) X402 runs:
  • Product Manager
  • UX
  • Frontend
  • Backend
  • DevOps
  • Technical Writer
  • Progress is shown
  • ZIP is generated
  • Redirected to Completion
6. Completion (/completion)
  • View summary
  • Download ZIP:
    • README
    • PRD
    • PLAN
    • Specs
    • Prompts
    • Infra
Optionally push to GitHub:
  • Connect GitHub
  • Create repo
  • Upload files5-Minute Quick Start
git clone <repository-url>
cd scriptonia
npm install
cp env.example .env

Edit .env

  • Set DATABASE_URL (PostgreSQL)
  • Set one AI key:
    • OPENAI_API_KEY
    • OPENROUTER_API_KEY_GROK4
npx prisma migrate dev
npm run dev
Open:
http://localhost:3000
You can complete:
  • Idea
  • Intent
  • See Platform options
For Payment → Execution → Completion, add Solana or Dodo
(see Prerequisites Checklist).

Prerequisites Checklist

System

  • Node.js 18+
    • node -v
  • npm (or yarn)
    • npm -v
  • PostgreSQL
    • Local or Supabase, Neon, Railway, etc.

Environment Variables

  • DATABASE_URL
    • Connection string in .env
  • OPENAI_API_KEY or OPENROUTER_API_KEY_*
    • Required for Idea, Intent, Platform, Execution
    • One of:
      • OPENAI_API_KEY
      • OPENROUTER_API_KEY_GROK4
      • OPENROUTER_API_KEY_QWEN3
      • OPENROUTER_API_KEY_GEMINI2_5

Payments (Optional)

Solana (crypto)

  • RPC
  • TREASURY_WALLET
  • SCRIPT_TOKEN_MINT
  • Use NEXT_PUBLIC_SOLANA_NETWORK=devnet for testing
  • Helius or public RPC

Wallet

  • Phantom / AppKit
  • NEXT_PUBLIC_REOWN_PROJECT_ID

Dodo (card / UPI)

  • DODO_API_KEY
  • DODO_WEBHOOK_SECRET
  • DODO_PRODUCT_ID
  • NEXT_PUBLIC_APP_URL
Webhook:
https://your-domain/api/dodo/webhook

GitHub (Optional)

  • GITHUB_CLIENT_ID
  • GITHUB_CLIENT_SECRET
  • GITHUB_CALLBACK_URL
Local callback:
http://localhost:3000/api/github/callback

Minimal Setup

  • DATABASE_URL
  • One AI key
(Idea → Intent → Platform only)

Full Flow Setup

  • Above
  • Solana or Dodo
(through Completion)

Step-by-Step First Project

1. Idea (/)

  • Enter an idea
    Example: “A todo app for remote teams with assignees and due dates”
  • Submit
AI returns:
  • Analysis
  • Clarifying questions

2. Intent (/intent)

  • Answer the questions in the chat
    Examples:
    • Target users
    • Must-have vs nice-to-have features
  • Submit
AI produces refined requirements:
  • Title
  • Features
  • Audience
  • Tech notes

3. Platform (/platform)

  • Review options:
    • Website
    • Web Application
    • Android
    • iOS
  • Includes cost and timeline
  • Select one
  • Redirected to Payment

4. Payment (/payment)

Solana

  • Connect Phantom (or AppKit)
  • Ensure $SCRIPT or SOL (devnet ok for testing)
  • Approve the transfer
  • On success → Execution

Dodo

  • Click “Buy with Card”
  • Complete checkout
  • Redirected to /payment/success
  • Webhook confirms → Execution

5. Execution (/execution)

X402 runs:
  • Product Manager
  • UX
  • Frontend
  • Backend
  • DevOps
  • Technical Writer
  • Progress is shown
  • ZIP is generated
  • Redirected to Completion

6. Completion (/completion)

  • View summary
  • Download ZIP:
    • README
    • PRD
    • PLAN
    • Specs
    • Prompts
    • Infra
Optionally push to GitHub:
  • Connect GitHub
  • Create repo
  • Upload files