create-fastreact

> Archived: This project is no longer actively maintained. Feel free to fork it if you'd like to continue development.

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

``bash
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: Cloudflare Pages (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)

Quick Start

1. Create your app:
`bash
pnpm create fastreact my-app
`

The CLI verifies prerequisites (Claude Code, Modal), then prompts for:
- Project name
- App description (plain English)
- Proxy auth tokens (optional)

2. Enter the project directory (required):
`bash
cd my-app
`

3. Run the AI agent:
`bash
cd my-app/agent
uv run agent
`

Or run directly with instructions (creates app_spec.md automatically):
`bash
uv run agent "Build a todo app with categories and due dates"
`

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

Resume an interrupted session (skips initializer):
`bash
uv run agent --continue
`

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

`bash
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

$3

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

$3

`bash
cd backend
modal deploy modal_app.py
`

$3

Deploy to Cloudflare Pages via the dashboard or CLI:

`bash
cd frontend
pnpm build
wrangler pages deploy dist --project-name=my-app
`

Set environment variables in Cloudflare Pages:
- VITE_API_URL - Modal production URL
- VITE_MODAL_KEY - Proxy auth token ID
- VITE_MODAL_SECRET` - Proxy auth token secret

License

MIT