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-typescript generates a typed client from FastAPI's OpenAPI schema
  • Task runner: just — the scaffold writes a root justfile (install, db-up, db-down, backend, frontend, dev, generate-api). just dev runs backend + frontend together (Ctrl+C stops both); it does not start Postgres — run just db-up first. It uses set shell := ["bash", "-uc"] for &/wait, so Git Bash must be on PATH on Windows. Run just with no args to list recipes; always drive the project through just <recipe> instead of raw uv run / bun run / docker compose commands.
  • 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>
Installs
13
Repository
bmsuisse/skills
GitHub Stars
2
First Seen
Mar 18, 2026
init-app-stack — bmsuisse/skills