Project Scaffolding Wizard
Professional-grade project scaffolding comparable to WebStorm/PyCharm project wizards. Creates fully configured projects with SDK setup, framework options, database configuration, linting, and CI/CD.
Wizard Workflow
When a user requests a new project, follow this interactive workflow:
Step 1: Project Type Selection
Present the project type menu. Ask the user to select a category and type:
| Category | Types |
|---|---|
| Static Websites | HTML5 (no CSS), HTML/CSS, HTML+Sass, HTML+Tailwind, Landing Page, Multi-page Site |
| Frontend Web | React, Next.js, Vue, Nuxt, Svelte, Angular, Astro, Remix, Solid, Qwik, Preact |
| Mobile/Desktop | React Native, Expo, Flutter, Tauri, Electron, Ionic |
| Backend (JS/TS) | Express, NestJS, Fastify, Hono, Elysia, tRPC, Koa |
| Backend (Python) | FastAPI, Django, Django REST, Flask, Litestar |
| Backend (Go) | Gin, Fiber, Echo, Chi |
| Backend (Rust) | Axum, Actix, Rocket |
| Backend (Java) | Spring Boot, Quarkus, Ktor, Micronaut |
| Backend (Other) | Laravel, Rails,.NET Web API |
| Libraries | TypeScript NPM, Python PyPI, Go Module, Rust Crate |
| CLI Tools | Node CLI, Python CLI (Typer/Click), Go CLI (Cobra), Rust CLI (Clap) |
| Extensions | Chrome Extension, Firefox Extension, VS Code Extension, Figma Plugin, Obsidian Plugin |
| Serverless | AWS Lambda, Cloudflare Workers, Vercel Functions, Supabase Functions |
| Full-Stack | T3 Stack, MERN, PERN, MEAN |
| Monorepos | Turborepo, Nx Workspace, pnpm Workspace |
Step 2: Basic Configuration
Gather for ALL projects:
- Project name (required)
- Location/directory
- Description
- Author name
- License (MIT, Apache-2.0, GPL-3.0, ISC, Unlicense)
Step 3: Framework-Specific Options
Load references/wizard-options.md for detailed configuration options based on the selected project type. Key decisions include:
- Language/SDK version - Node.js, Python, Go, Rust, Java versions
- Package manager - npm, pnpm, yarn, bun, poetry, uv
- CSS framework - Tailwind, CSS Modules, Styled Components
- State management - Zustand, Redux, Jotai, TanStack Query
- Database/ORM - PostgreSQL, SQLite, Prisma, SQLAlchemy, sqlc
- Authentication - NextAuth, JWT, OAuth2
- Testing - Vitest, Jest, pytest, Playwright
Step 4: Code Quality & DevOps
- Linting - ESLint, Ruff, golangci-lint, clippy
- Formatting - Prettier, Ruff, gofmt, rustfmt
- Pre-commit hooks - husky + lint-staged, pre-commit framework
- CI/CD - GitHub Actions, GitLab CI
- Docker - Dockerfile (multi-stage), docker-compose
- Deployment - Vercel, Railway, Fly.io, AWS, self-hosted
Step 5: Generate Project
Use scripts/scaffold.py or native CLI tools to create the project structure.
CLI Integration
Prefer native CLI tools when available:
| Framework | CLI Command |
|---|---|
| Next.js | npx create-next-app@latest |
| React (Vite) | npm create vite@latest -- --template react-ts |
| Vue | npm create vue@latest |
| Nuxt | npx nuxi@latest init |
| Astro | npm create astro@latest |
| Remix | npx create-remix@latest |
| SvelteKit | npm create svelte@latest |
| Solid | npm create solid@latest |
| Expo | npx create-expo-app@latest |
| React Native | npx @react-native-community/cli init |
| Flutter | flutter create |
| Tauri | npm create tauri-app@latest |
| NestJS | npx @nestjs/cli new |
| Spring Boot | spring init or start.spring.io |
| Go | go mod init |
| Rust | cargo new |
| Chrome Ext | npm create plasmo@latest |
| T3 Stack | npx create-t3-app@latest |
Quick Start Examples
HTML/CSS Website
mkdir my-website && cd my-website
touch index.html style.css
# Or use boilerplate:
npx degit h5bp/html5-boilerplate my-websiteHTML + Tailwind (CDN)
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>My Website</title>
<script src="https://cdn.tailwindcss.com"></script>
</head>
<body class="bg-gray-100">
<h1 class="text-3xl font-bold">Hello World</h1>
</body>
</html>T3 Stack (Next.js + tRPC + Prisma)
npx create-t3-app@latest my-appExpo (React Native)
npx create-expo-app@latest my-app --template tabsTauri Desktop App
npm create tauri-app@latest my-app -- --template react-tsChrome Extension
npm create plasmo@latest my-extensionExample Conversations
Simple HTML/CSS Website
User: Create a simple website with HTML and CSS
Claude: I'll create a static HTML/CSS website:
- Multi-page (Home, About, Contact)
- Mobile-first responsive CSS
- BEM naming convention
- Live Server for development
Structure:
my-website/
├── index.html
├── about.html
├── contact.html
├── css/style.css
├── js/main.js
└── images/
Shall I create this?Mobile App
User: Create a mobile app for iOS and Android
Claude: I recommend Expo for the easiest setup:
- TypeScript
- Expo Router (file-based navigation)
- NativeWind (Tailwind for RN)
- Tab navigation template
Ready to scaffold?Full-Stack with Type Safety
User: Create a full-stack app with type-safe API
Claude: I recommend the T3 Stack:
- Next.js 16 (App Router)
- tRPC (type-safe API)
- Prisma (type-safe ORM)
- Tailwind CSS
- NextAuth.js
- PostgreSQL with docker-compose
This gives you full type safety from database to frontend!Chrome Extension
User: Build a Chrome extension
Claude: What features do you need?
- Popup UI
- Content script (modifies pages)
- Background service worker
- Side panel
Tech stack: React + Vite + TypeScript + Manifest V3
I recommend using Plasmo framework for easier development.Available Resources
Load reference files based on what you need:
| Resource | When to Load | Purpose |
|---|---|---|
references/wizard-options.md | During Step 3 (gathering user preferences) | Configuration choices and defaults for each framework |
references/frameworks.md | When generating code | Project structures, code examples, configuration files |
references/best-practices.md | For architecture decisions | Directory organization, naming conventions, patterns |
scripts/scaffold.py | For custom scaffolding | Python engine when CLI tools aren't suitable |
Workflow:
- Present options from
wizard-options.mdto gather user preferences - Use
frameworks.mdfor code patterns and project structure when generating - Consult
best-practices.mdfor architecture decisions
Default Recommendations
| Category | Recommendation |
|---|---|
| JS Runtime | Node.js 24 LTS |
| Package Manager | pnpm |
| Python Version | 3.14 |
| Go Version | 1.26 |
| Rust Edition | 2024 |
| Java Version | 21 LTS |
| CSS Framework | Tailwind CSS |
| State (React) | Zustand + TanStack Query |
| ORM (Node) | Prisma |
| ORM (Python) | SQLAlchemy 2.0 |
| ORM (Go) | sqlc |
| Testing (JS) | Vitest |
| Testing (Python) | pytest |
| E2E Testing | Playwright |
| Linting (JS) | ESLint + Prettier |
| Linting (Python) | Ruff |
| CI/CD | GitHub Actions |
| Containerization | Multi-stage Dockerfile |