create-fastreact

AI-first full-stack framework. Describe your app, let AI build it.

pnpm create fastreact my-app

What you get

• Frontend: React 19 + Vite + TypeScript + Tailwind CSS v4 + shadcn/ui
• Backend: FastAPI on Modal (serverless Python)
• AI Agent: Autonomous coding agent that builds your app from a description
• Deployment: Vercel (frontend) + Modal (backend)

How it works

1. Describe your app in plain English
2. AI creates a feature list from your description
3. AI implements features one by one, testing each
4. You review and iterate as it builds

Based on Anthropic's autonomous coding architecture.

Prerequisites

• Node.js 18+
• pnpm
• Python 3.12+
• uv (Python package manager)
• Claude Code (logged in)
• Modal CLI (logged in)
• Vercel CLI (logged in)

Quick Start

1. Create your app:

pnpm create fastreact my-app

The CLI verifies prerequisites (Claude Code, Modal, Vercel), then prompts for:

• Project name
• App description (plain English)
• Proxy auth tokens (optional)

2. Enter the project directory (required):

cd my-app

3. Run the AI agent:

pnpm run agent

The agent will:

• Session 1 (Initializer): Create feature_list.json from your description
• Session 2+ (Coding): Implement features one by one

4. Monitor progress:

• feature_list.json - Track which features are done
• claude-progress.txt - Session notes from the AI
• git log - See commits for each feature

Manual Development

cd my-app
pnpm run dev   # Start frontend + backend dev servers

• Frontend: http://localhost:5173
• Backend: Modal serve (hot-reloading)

Project Structure

my-app/
├── frontend/           # React + Vite + Tailwind
├── backend/            # FastAPI on Modal
├── agent/              # AI coding agent
│   ├── agent.py        # Main agent script
│   ├── prompts/        # Customizable prompts
│   └── .env.example    # Environment config template
├── app_spec.md         # Your app description
├── feature_list.json   # AI-generated feature list
└── claude-progress.txt # AI session notes

Configuring the Agent

Customizing Prompts

Edit the prompts in agent/prompts/:

• initializer_prompt.md - How features are broken down
• coding_prompt.md - How features are implemented

Why fastreact?

• AI-first: Describe what you want, AI builds it
• Full-stack: React frontend + FastAPI backend
• Serverless: Deploy to Modal with zero infrastructure
• Modern stack: Vite, Tailwind v4, shadcn/ui, TypeScript
• Incremental: AI commits after each feature, easy to review

Deployment

Backend

cd backend
modal deploy modal_app.py

Frontend

cd frontend
vercel

Set environment variables in Vercel:

• VITE_API_URL - Modal production URL
• VITE_MODAL_KEY - Proxy auth token ID
• VITE_MODAL_SECRET - Proxy auth token secret

License

MIT