fastreactlisted

# fastreact — FastAPI + React full-stack webapp Build a production-shaped full-stack web app from a mockup to a running Docker Compose stack. **Backend:** FastAPI, uv, SQLModel, Postgres, Alembic, JWT + Google OAuth, boto3 (S3). **Frontend:** Vite, React, TypeScript, shadcn/ui + Tailwind, TanStack Router (file-based) / Query / Table, Zod, Axios. **Infra:** Docker Compose (postgres + backend + frontend), seeded test users, agent-browser E2E. ## When to use - "Spin up / bootstrap / create a full-stack webapp", "FastAPI + React", "Python backend + React frontend". - An admin panel, client portal, dashboard, or internal tool with auth + RBAC + file upload + S3. - API-first backend with a typed SPA; local docker dev with seeded users. ## Scope This skill handles scaffolding, conventions, and local setup for a FastAPI+React+Postgres+S3 webapp. It does NOT: deploy to cloud, generate raster brand art itself (delegates to `vd:marketing-design`), or design HTML pages itself (delegates to `vd:opendesign`). For pure UI-token/Tailwind work use `vd:webdesign`. Never put secrets in tracked files; always a gitignored `.env`. ## Workflow (numbered) ### 1. Mockup first (design before code) Lock the look before writing app code. Save artifacts under `.work/visuals/{app-slug}/` (or `plans/visuals/{app-slug}/`), where `{app-slug}` is a kebab-case name for the app/feature. 1. **Brand/logo (raster):** use `marketing-design` (`design logo` / `create CIP`) for the mark + favicons. Engine: Codex