scaffold-fullstack-web

Load this skill when starting or scaffolding a new fullstack web app (Python service + web frontend in one repo): laying out the backend and frontend trees side by side and writing a combined .gitigno

SKILL.md

GitHub

Scaffold a Fullstack Web App

A fullstack repo is the composition of a Python service and a web frontend. Scaffold each side per its own skill, then place them side by side.

project/
├── backend/                # see scaffold-python-service
│   ├── app/{api,core,models,services,db}/
│   └── tests/{unit,integration,system}/
├── frontend/               # see scaffold-web-frontend
│   └── src/{lib,routes}/
├── migrations/             # Alembic
└── .gitignore              # combined entries below

Keep the two stacks independently buildable and testable — the backend exposes an API; the frontend consumes it through its src/lib/api client. Do not share runtime code across the boundary.

Combined .gitignore

# Python
.venv/
__pycache__/
*.pyc
*.egg-info/
.coverage
.pytest_cache/
.mypy_cache/
.ruff_cache/
*.db

# Node / frontend
node_modules/
.svelte-kit/

# Build output (both)
dist/
build/

# Secrets / env
.env
.env.*
!.env.example

# OS
.DS_Store