> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scriptonia.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# quick-start

## 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](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](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

***