Stack Composer

Scaffold modern web projects — fast, clean, complete.

A professional CLI tool that combines interactive menus, flag-based workflows, and AI-agent compatibility to create fully-configured projects in seconds.

Features

• Beautiful interactive UI — Elegant prompts with Figlet banners, Chalk colors, and Ora spinners
• 6 curated stacks — Next.js Full, Next.js + Shadcn, Astro, TanStack Start, Vite + React, SvelteKit
• Ultra-fast mode — --yes flag to accept all defaults
• AI-agent friendly — --json flag for structured output
• Hyper-optimized binary — Minified and lightweight (~16KB) for instant execution
• Smart flag merging — Flags fill in values, prompts ask only what's missing
• Zero-config Tailwind — Auto-configures VS Code to suppress Unknown at rule warnings
• Multi-PM support — pnpm (default), npm, or yarn

Installation

For the fastest possible experience (zero network latency), install it globally:

npm install -g stack-composer

Now you can just type:

stack-composer create

Usage Modes

Interactive Mode (default)

stack-composer create

Launches a beautiful interactive menu where you pick your stack, name, and options.

Flag Mode

stack-composer create next-full my-app --tailwind --eslint --git

Specify values via flags. Missing values will be prompted interactively.

Ultra-Fast Mode

stack-composer create next-full my-app --yes

Accepts all defaults. Zero prompts. Fastest possible project creation.

AI Agent Mode

stack-composer create next-full my-app --json --yes

Outputs a structured JSON object for programmatic use:

{
  "success": true,
  "projectPath": "/path/to/my-app",
  "stack": "next-full",
  "installedPackages": ["TypeScript", "Tailwind CSS", "ESLint"],
  "configApplied": ["base-scaffold", "post-setup", "tailwind-no-warnings", "git-init"],
  "packageManager": "pnpm",
  "messages": ["Project created in 12.3s"],
  "errors": [],
  "duration": 12345
}

List Stacks

stack-composer list          # Pretty output
stack-composer list --json   # JSON output

Available Stacks

Stack ID	Description
next-full	Next.js 15 (App Router) + TypeScript + Tailwind + ESLint + Prettier
next-shadcn	Next.js 15 + Tailwind + Shadcn/ui + TypeScript
astro	Astro + Tailwind + TypeScript
tanstack	TanStack Start (Router + Query) + Tailwind + TypeScript
vite-react	Vite + React + Tailwind + TypeScript
sveltekit	SvelteKit + Tailwind + TypeScript

Flags Reference

Flag	Description	Default
--tailwind	Include Tailwind CSS	true
--no-tailwind	Exclude Tailwind CSS
--eslint	Include ESLint	true
--no-eslint	Exclude ESLint
--prettier	Include Prettier	true
--no-prettier	Exclude Prettier
--git	Initialize Git + first commit	true
--no-git	Skip Git
--pm <manager>	Package manager: pnpm, npm, yarn	pnpm
-y, --yes	Accept all defaults
--json	Output JSON (for AI agents)
--skills	Comma-separated list of additional skills/packages to install	false

Development

# Clone and install
git clone  && cd stack-composer
pnpm install

# Build
pnpm build

# Test interactively
node dist/cli.js create

# Test with flags
node dist/cli.js create next-full test-app --yes

# Test JSON output
node dist/cli.js create next-full test-app --json --yes

# Watch mode
pnpm dev

Using from AI Agents

AI agents (Claude Code, Cursor, Aider, etc.) can call stack-composer programmatically:

# Create a project with JSON output
stack-composer create next-full my-project --json --yes 2>/dev/null

Parse the JSON response to verify success, check configApplied, and get the projectPath.

License

MIT

If you find any mistakes please open a Github Issue