@creativoma/create-stack

Interactive CLI to scaffold modern web projects with your preferred technology stack

 ██████╗██████╗ ███████╗ █████╗ ████████╗███████╗
██╔════╝██╔══██╗██╔════╝██╔══██╗╚══██╔══╝██╔════╝
██║     ██████╔╝█████╗  ███████║   ██║   █████╗
██║     ██╔══██╗██╔══╝  ██╔══██║   ██║   ██╔══╝
╚██████╗██║  ██║███████╗██║  ██║   ██║   ███████╗
 ╚═════╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝   ╚═╝   ╚══════╝

███████╗████████╗ █████╗  ██████╗██╗  ██╗
██╔════╝╚══██╔══╝██╔══██╗██╔════╝██║ ██╔╝
███████╗   ██║   ███████║██║     █████╔╝
╚════██║   ██║   ██╔══██║██║     ██╔═██╗
███████║   ██║   ██║  ██║╚██████╗██║  ██╗
╚══════╝   ╚═╝   ╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═╝

Quick Start

Choose your preferred package manager:

# npm
npx @creativoma/create-stack

# pnpm
pnpm dlx @creativoma/create-stack

# yarn
yarn dlx @creativoma/create-stack

# bun
bunx @creativoma/create-stack

# deno
deno run -A npm:@creativoma/create-stack

Requirements: Node.js 22+

Why create-stack?

Unlike single-purpose generators (create-react-app, create-next-app), create-stack offers:

• Complete stack composition: Framework + styling + database + tooling in one pass
• Framework agnostic: React, Vue, Svelte, Solid, or Vanilla - your choice
• Production-ready configs: Pre-configured TypeScript, ESLint, testing, and Docker setups
• Package manager aware: Detects and uses your preferred manager (npm/pnpm/yarn/bun)
• Type-safe architecture: Built with strict TypeScript and custom error handling
• Well-tested: 90%+ test coverage ensures reliability

Supported Technologies

Category	Options
Frameworks	React, Vue, Svelte, Solid, Vanilla
Meta-frameworks	Next.js, Nuxt, SvelteKit, Astro, Remix
Styling	Tailwind CSS, CSS Modules, Styled Components, UnoCSS
UI Components	shadcn/ui, Radix UI, Headless UI, Ark UI, Naive UI, PrimeVue
Database / ORM	Prisma, Drizzle, Supabase, Mongoose, Firebase, SQLite
Animation	Motion, GSAP, Lenis, Auto Animate, Anime.js
Code Quality	ESLint, Prettier, Biome
Testing	Vitest, Jest, Playwright, Cypress
Extras	Git initialization, Husky hooks, Docker, Environment files, VSCode settings

Technical Highlights

Clean Architecture

• SOLID principles: Single responsibility modules, dependency inversion via ExecutionContext pattern
• Custom error hierarchy: Type-safe error handling with rich context (ScaffoldingError, InstallationError, etc.)
• Zero parameter drilling: ExecutionContext eliminates passing 7-10 parameters through function chains
• Template system: Configuration generation separated from business logic

Code Quality

• Strict TypeScript: Full type coverage, no implicit any, proper null checks
• 90%+ test coverage: Comprehensive unit tests with success/error path coverage
• ESLint + Prettier: Enforced code style and quality standards
• Modular design: No circular dependencies, setup modules are independent

Developer Experience

• Interactive prompts: Validates inputs, provides sensible defaults
• Package manager detection: Auto-detects npm/pnpm/yarn/bun from lock files
• Rich feedback: Spinner animations and colored output for visual progress
• Error recovery: Detailed error messages with context for troubleshooting

See ARCHITECTURE.md for complete architectural documentation.

Usage Examples

Basic project with React + Tailwind

npx @creativoma/create-stack
# Select: React → Tailwind CSS → No database → Skip extras

Full-stack Next.js with Prisma

npx @creativoma/create-stack
# Select: Next.js → Tailwind + shadcn/ui → Prisma → Docker + Git + Husky

Vue 3 with Supabase backend

npx @creativoma/create-stack
# Select: Vue → UnoCSS → Supabase → Vitest

CLI Options

create-stack --help     # Display help information
create-stack --version  # Show installed version

No configuration file support yet - all options are interactive prompts.

Development

Prerequisites

• Node.js 22 or higher
• pnpm (recommended) or npm

Setup

git clone https://github.com/creativoma/create-stack.git
cd create-stack
pnpm install

Available Commands

pnpm dev              # Build and run CLI locally
pnpm build            # Compile TypeScript to dist/
pnpm test             # Run test suite
pnpm test:watch       # Run tests in watch mode
pnpm test:coverage    # Generate coverage report
pnpm lint             # Check code style
pnpm lint:fix         # Auto-fix linting issues
pnpm typecheck        # Verify TypeScript types

Testing Locally

pnpm dev
# Or after building:
node dist/index.js

Contributing

Contributions are welcome. Please read CONTRIBUTING.md for:

• Code style guidelines
• Testing requirements
• Pull request process
• Development workflow

Architecture

This project follows SOLID principles with a modular architecture:

• ExecutionContext pattern for dependency injection
• Custom error types for type-safe error handling
• Template system for configuration generation
• Independent setup modules for each feature category

For detailed architectural documentation, see ARCHITECTURE.md.

License

This project is licensed under the MIT License. See the LICENSE file for details.