create-frontstack

One command → a modern, production-ready React + TypeScript + Vite frontend repo with Docker, TanStack Router/Query, Zustand, shadcn/ui, and a curated set of agent skills + MCP servers.

pnpm create frontstack my-app
# or: npm create frontstack@latest my-app
# or: npx create-frontstack my-app

What you get

A single-package (non-monorepo) frontend project, ready for solo development:

• React 19 + TypeScript 6 + Vite 8 (Tailwind v4, CSS-first)
• TanStack Router (file-based, type-safe) + TanStack Query (server state)
• Zustand (client/UI state) — server-state lives in Query, never duplicated in stores
• shadcn/ui (v4) with a starter Button
• Vitest + happy-dom (unit/component) and Playwright (E2E) as separate layers
• ESLint (flat, type-aware) + Prettier
• Docker — multi-stage production image (nginx) + dev image + compose
• Agent skills (skills/, wired to .claude by default) and a fixed MCP bundle (shadcn, context7, playwright, chrome-devtools)

The CLI has zero runtime dependencies (Node built-ins only), so npx is instant.

Usage

pnpm create frontstack my-app
cd my-app
pnpm install
npx playwright install   # E2E + playwright/chrome-devtools MCP
pnpm dev

Flags for non-interactive / CI use:

npx create-frontstack my-app --skills=claude,agents   # pick skill clients
npx create-frontstack my-app --no-skills              # skip skills entirely

Then run the quality gate:

pnpm check      # typecheck + lint + test
pnpm build      # route codegen + typecheck + bundle

Development of this package

pnpm install
pnpm check                  # lint + test the CLI
pnpm test                   # unit tests + generation gate

The generated project is itself the unit under test: the suite runs the CLI into a temp dir and (when Node/Docker are available) exercises pnpm check / pnpm build on the output.

Publishing

npm pack --dry-run          # confirm bin/ + template/ (incl. underscore dotfiles) are included
npm version <patch|minor|major>
npm publish --access public --provenance

files: ["bin", "template"] — only those are published. Dotfiles that npm mangles on publish are stored in the template as _gitignore / _npmrc / _nvmrc and renamed to real dotfiles at generation time.

License

MIT © Igor Martynov