Idea Wizard

Idea Wizard is an AI-powered app planning tool that interrogates your app idea until no assumptions remain, generates a complete suite of canonical documentation, and exports a Cursor-ready project scaffold you can start building from immediately.

The Problem

Most app ideas fail before a single line of code is written — not because the idea is bad, but because the thinking is incomplete. Developers jump into code with vague requirements, undefined data models, and no design system. AI coding assistants hallucinate when your clarity ends.

Idea Wizard forces clarity before code.

How It Works

The app follows a three-phase workflow:

1. Interrogation

You start by describing your idea in as much detail as you have. Then the Wizard — an AI product strategist — tears your idea apart with structured multiple-choice questions (2-3 options + an "Other" field for open-ended answers). Each question maps to a specific documentation area. The interrogation continues until there are no assumptions left.

You can also build a moodboard during this phase by uploading screenshots, images, or pasting URLs to design references. The AI analyzes each reference and extracts colors, typography, layout patterns, and design style.

2. Documentation

Once the interrogation is complete, the AI generates eight canonical files from the full transcript:

Document	Purpose
PRD.md	What we're building, for whom, and how we measure success
APP_FLOW.md	How users move through the app, step by step
TECH_STACK.md	Exact tools, versions, and integrations — no ambiguity
FRONTEND_GUIDELINES.md	Design system: colors, typography, spacing, component patterns
BACKEND_STRUCTURE.md	Database tables, relationships, auth rules, API contracts
IMPLEMENTATION_PLAN.md	Phased build order with checkpoints
CLAUDE.md	AI operating manual for future coding sessions
progress.txt	Session tracking so AI picks up where you left off

Each document is editable. Changes automatically cascade across all other documents — if you update the tech stack, the backend structure and implementation plan update too.

3. Review & Export

Review all documents, make final edits, then export a complete project scaffold as a zip file (or send it via email). The exported zip includes:

• All 8 documentation files at the project root
• A src/ folder with starter app structure (layout, page, styles)
• A pre-configured package.json, tsconfig.json, and next.config.ts
• A .env file with all required API keys pre-listed (awaiting your secrets)
• A moodboard/ folder with analyzed design references
• A full README.md with setup instructions

Open the zip in Cursor and start building. Every AI session reads CLAUDE.md and progress.txt automatically.

Tech Stack

• Next.js 16 (App Router) + React 19 + TypeScript
• Tailwind CSS 4 with custom solarpunk + neobrutalist design tokens
• Supabase — Postgres database, email/password auth, file storage (moodboard images)
• OpenAI GPT-4o — Interrogation, document generation, cascade updates, image analysis
• Resend — Email delivery for exported scaffolds
• JSZip + FileSaver — Client-side zip generation and download
• PWA — Installable on mobile with offline support for static pages

Getting Started

Prerequisites

• Node.js 18+
• A Supabase project with the required tables (see BACKEND_STRUCTURE.md)
• An OpenAI API key
• A Resend API key (for email export)

Setup

# Install dependencies
npm install

# Copy the example env and fill in your keys
cp .env.example .env.local

# Run the dev server
npm run dev

Open http://localhost:3000 in your browser.

Environment Variables

Variable	Description
OPENAI_API_KEY	OpenAI API key for GPT-4o
RESEND_API_KEY	Resend API key for email export
NEXT_PUBLIC_SUPABASE_URL	Your Supabase project URL
NEXT_PUBLIC_SUPABASE_ANON_KEY	Supabase anonymous/public key
SUPABASE_SERVICE_ROLE_KEY	Supabase service role key (server-side only)

Project Structure

idea-wizard/
├── src/
│   ├── app/              → Pages, routes, API endpoints
│   ├── components/       → Auth, landing, wizard, UI components
│   ├── lib/
│   │   ├── export/       → Scaffold builder + zip generation
│   │   ├── prompts/      → AI system prompts
│   │   ├── supabase/     → Browser, server, middleware clients
│   │   ├── types/        → TypeScript type definitions
│   │   └── utils/        → Theme utilities
│   └── styles/
├── public/               → PWA manifest, service worker, icons
├── middleware.ts          → Auth route protection
├── CLAUDE.md             → AI operating manual
├── progress.txt          → Session tracking
├── PRD.md                → Product requirements
├── APP_FLOW.md           → User flows
├── TECH_STACK.md         → Locked dependencies
├── FRONTEND_GUIDELINES.md → Design system
├── BACKEND_STRUCTURE.md  → Database + API spec
└── IMPLEMENTATION_PLAN.md → Build order