Project Scaffolder

Generate production-ready starter repositories with best-practice conventions for any tech stack.

Core Workflow

• Determine stack: Ask user to specify or infer from context (Next.js, Vite, Nest, FastAPI, etc.)

• Select template: Use references/templates.md to choose the appropriate project structure

• Generate structure: Create complete folder tree with all necessary files

• Add baseline code: Include working "hello world" route/page as proof of concept

• Configure tooling: Add package.json/requirements.txt, tsconfig, linting, formatting configs

• Create scripts: Include dev, build, test, and deployment scripts

• Document setup: Generate comprehensive README with setup steps and next actions

Key Deliverables

Every scaffolded project must include:

• Folder tree: Well-organized src/, lib/, config/, tests/ structure

• Baseline code: Working hello world endpoint or page

• Package files: package.json, requirements.txt, Cargo.toml, etc.

• Configs: TypeScript, ESLint, Prettier, environment files (.env.example)

• Scripts: npm scripts or Makefile for common tasks

• README: Setup instructions, tech stack overview, next steps

• Git setup: .gitignore configured for the stack

Stack-Specific Patterns

See references/templates.md for detailed patterns per stack:

• Next.js App Router

• Vite + React

• NestJS

• FastAPI

• Express + TypeScript

• Vue + Vite

• SvelteKit

Best Practices

• Use absolute imports (@/ alias) where supported

• Include environment variable templates

• Add basic error handling and logging setup

• Configure path mappings in tsconfig

• Include Docker files for containerization (optional)

• Add GitHub Actions or CI workflow templates (optional)

Progressive Enhancement

Start with minimal viable structure, then add:

• Database setup (Prisma, TypeORM, SQLAlchemy)

• Auth scaffolding (NextAuth, Passport, JWT)

• API client setup (Axios, Fetch wrapper)

• State management (Zustand, Redux, Pinia)

• Testing setup (Jest, Vitest, Pytest)

Output Structure

Present the complete project tree first, then create all files in proper locations. Always provide a summary of what was created and next steps to run the project.