mvp-scaffold

MVP Scaffold - Startup Project Scaffolding

Overview

Generates a complete, production-ready project skeleton optimized for startup speed. From zero to deployable in minutes, not days.

---

1. When to Apply

Trigger	Behavior
New project creation	Full scaffolding with interactive stack selection
Adding a new service to monorepo	Service scaffolding within existing structure
"scaffold", "init", "bootstrap" keywords	Activate scaffolding workflow

---

2. Supported Stacks

Frontend

Stack	Template	Best For
Next.js 15 (App Router)	next-startup	Full-stack web app
React + Vite	react-vite	SPA / Dashboard
React Native (Expo)	expo-startup	Mobile-first product

Backend

Stack	Template	Best For
Next.js API Routes	(included in next-startup)	Simple API
FastAPI	fastapi-startup	Python / AI / Data
Spring Boot (Kotlin)	spring-startup	Enterprise B2B
NestJS	nest-startup	Complex Node.js API

Database

Choice	Setup Included
Supabase (PostgreSQL)	Auth + DB + Storage + Realtime
Prisma + PostgreSQL	ORM + migrations + seeding
Drizzle + PostgreSQL	Lightweight ORM + type-safe
MongoDB Atlas	Mongoose models + connection

---

3. Scaffolding Flow

Phase 1: Stack Selection

1. Ask product type (web/mobile/api/full-stack)
2. Ask backend preference (or recommend based on team skills)
3. Ask database preference (or recommend based on data model)
4. Ask auth method (Supabase Auth / Clerk / NextAuth)
5. Ask deployment target (Vercel / Railway / Docker)

Phase 2: Project Generation

Next.js Startup Template Structure:

{project-name}/
├── src/
│   ├── app/
│   │   ├── layout.tsx          # Root layout with providers
│   │   ├── page.tsx            # Landing page
│   │   ├── (auth)/
│   │   │   ├── login/page.tsx
│   │   │   └── signup/page.tsx
│   │   ├── (dashboard)/
│   │   │   └── page.tsx
│   │   └── api/
│   │       └── health/route.ts # Health check endpoint
│   ├── components/
│   │   ├── ui/                 # shadcn/ui components
│   │   └── layout/
│   ├── lib/
│   │   ├── supabase.ts        # DB client
│   │   ├── utils.ts
│   │   └── constants.ts
│   └── types/
│       └── index.ts
├── prisma/                     # If Prisma selected
│   └── schema.prisma
├── public/
├── .env.example                # Environment template
├── .env.local                  # (gitignored)
├── .gitignore
├── package.json
├── tsconfig.json
├── tailwind.config.ts
├── next.config.ts
├── docker-compose.yml          # Local dev DB
├── Dockerfile                  # Production build
├── .github/
│   └── workflows/
│       └── ci.yml              # CI pipeline
├── CLAUDE.md                   # AI context
└── README.md