Fullstack Project Scaffolding and Code Audit
Scaffold a working fullstack slice, choose a maintainable stack, and rank code risks with concrete fixes and verification steps.
Before & after
Same prompt, same agent — the only difference is the skill.
That's a good stack for scalability. Before I generate a full scaffold, I'd want to clarify: Are you using TypeScript on the frontend? Do you need real-time features or just REST? How about authentication—JWT, OAuth? What database are you targeting? Will you need Docker? Once I understand your architecture goals, I can give you a scaffold that fits.
FULLSTACK PROJECT SCAFFOLD
STACK SELECTION RATIONALE
Backend: FastAPI (async-first, auto OpenAPI docs, 30k stars)
Frontend: React 18 + Vite (ESM, <200ms cold start)
Database: PostgreSQL + SQLAlchemy
Deploy: Docker + Railway or Vercel (client) + Railway (server)
PROJECT STRUCTURE
backend/
app/
main.py (FastAPI instance)
routes/ (todos, users, auth)
models.py (SQLAlchemy ORM)
schemas.py (Pydantic for validation)
.env.example
Dockerfile
requirements.txt
frontend/
src/
components/ (React)
hooks/ (useAuth, useTodos)
pages/ (React Router)
vite.config.ts
.env.example
Dockerfile
COMPLETE FILES GENERATED
✓ Auth system (JWT + refresh tokens)
✓ CORS configured
✓ Database migrations (Alembic)
✓ Error handling (consistent 4xx/5xx)
✓ .dockerignore, .gitignore
✓ CI/CD skeleton (GitHub Actions)
NEXT: Run `make setup` (installs deps, creates DB, seeds test data)About this skill
Your starter app boots, but the browser cannot reach the API, database changes have no migration path, and authentication never reaches the actual data query. This skill builds one connected feature across the stack and audits existing code for concrete security, correctness, and complexity problems.
What it does
- Chooses among Next.js, FastAPI with React, MERN, and Django using team skills, application needs, and deployment constraints.
- Scaffolds one working path from a user action through validation and persistence to the rendered result.
- Connects environment configuration, database migrations, API contracts, and local startup instructions.
- Checks authorization at data access, browser/server boundaries, error handling, and query behavior.
- Ranks audit findings with explicit severity criteria, evidence, focused fixes, and regression checks.
- Separates implemented code, executed checks, and remaining deployment requirements.
What you get
For a new project, you get a minimal connected implementation with setup instructions and verification steps. For an existing project, you get prioritized findings and focused patches; for a stack question, a recommendation with the conditions that would change it.
Best for
Developers and small teams starting web applications, untangling frontend/backend integration, or reviewing an existing Next.js, FastAPI, MERN, or Django codebase before expanding it.
SKILL.md preview
---
name: fullstack-project-scaffolding-and-code-audit
description: Scaffold connected web application features across Next.js, FastAPI with React, MERN, and Django; choose a maintainable stack; and audit security, correctness, and complexity using traceable evidence and targeted verification. Use when the user says "scaffold a new project", "set up FastAPI with React", "create a Next.js starter", "what stack should I use", "audit my codebase", "my frontend cannot talk to my backend", "my starter runs but nothing saves", or "this codebase is getting hard to change".
---
# Fullstack Project Scaffolding and Code Audit
… (sign up to view the full skill)More development skills
View all Development skills →Performance Bottleneck Profiling: Node, Python, Go
Classifies a slowdown, gives exact profiler commands, reads the output, and proves the fix with same-conditions p95/p99 numbers.
Feature Scaffolding with Working Tests
Turn a short feature spec into code, runnable tests, and integration wiring that match your existing project.
Feature Flag Rollouts and Kill Switches
Design staged flag rollouts, verify rollback paths, and audit flag debt with explicit defaults, gates, and retirement plans.
Microcontroller Firmware and RTOS Engineering
Build and debug MCU firmware with bounded ISR/RTOS timing, safe DMA ownership, and measured power budgets.