claude-app-scaffold

Scaffold a FastAPI + Claude API + Railway + Netlify project in 30 seconds.

5 questions, and you get a working backend (FastAPI + Anthropic SDK), a vanilla HTML/CSS/JS frontend, deployment files for Railway and Netlify, GEO basics (llms.txt, robots.txt, sitemap.xml, Schema.org JSON-LD), and a CLAUDE.md pre-filled so Claude Code has full context from the first message.

Install

pip install claude-app-scaffold

Usage

Interactive mode — 5 questions (name, type, model, description, addons):

claude-app-scaffold

Non-interactive mode, for scripting:

claude-app-scaffold --name "My App" --type chatbot --model haiku \
  --description "A support chatbot for my SaaS" \
  --auth --postgres --output .

Project types

What you get

my-app/
├── CLAUDE.md          # project context, pre-filled for Claude Code
├── README.md
├── .gitignore
├── backend/
│   ├── main.py        # FastAPI app, routes match the chosen type
│   ├── requirements.txt
│   ├── Procfile       # Railway
│   ├── runtime.txt
│   ├── env.example
│   └── utils/
└── frontend/
    ├── index.html     # vanilla HTML/CSS/JS, Schema.org JSON-LD
    ├── llms.txt
    ├── robots.txt
    └── sitemap.xml

Then:

cd my-app/backend
pip install -r requirements.txt
cp env.example .env   # fill in ANTHROPIC_API_KEY
uvicorn main:app --reload

Deploy backend/ to Railway and frontend/ to Netlify.

Why

Every FastAPI + Claude project starts with the same boilerplate — CORS, env vars, a Claude client wrapper, a Procfile, GEO basics. This CLI generates that scaffold so you can start on the actual product instead.

License

MIT — see LICENSE.

Built by Raymond Gadji.