init-app-stack
Installation
SKILL.md
Init App Stack
Bootstrap a full-stack project with:
- Frontend: Vite 8+ + React + TanStack Router + TanStack Query + TanStack Form + TanStack Table + TanStack Virtual + Zustand + shadcn/ui + TailwindCSS v4, managed with bun
- Backend: FastAPI + Granian + raw asyncpg (Postgres), managed with uv, targeting Python 3.14 (PEP 750 t-strings for SQL)
- DB: Postgres 17 via
docker-compose.yml - Types:
openapi-typescriptgenerates a typed client from FastAPI's OpenAPI schema - Task runner:
just— the scaffold writes a rootjustfile(install,db-up,db-down,backend,frontend,dev,generate-api).just devruns backend + frontend together (Ctrl+C stops both); it does not start Postgres — runjust db-upfirst. It usesset shell := ["bash", "-uc"]for&/wait, so Git Bash must be onPATHon Windows. Runjustwith no args to list recipes; always drive the project throughjust <recipe>instead of rawuv run/bun run/docker composecommands. - Ports: randomly assigned high ports (seeded by project name, so deterministic per project — printed on scaffold completion)
Step 1: Run the scaffold script
This creates the full project structure deterministically — do not scaffold manually.
uv run python scripts/create.py <project-name>