starter-structure-cli

Scaffold starter projects from stack combinations like react vite ts tailwind express prisma mysql.

starter-structure-cli supports direct template selection, interactive prompts, and natural stack queries. It ships with frontend, backend, fullstack, and monorepo starters built from layered template sources.

Installation

Run with npx:

npx starter-structure-cli my-app

Or use the standard npm create flow:

npm create starter-structure-cli@latest my-app

Or install globally:

npm install -g starter-structure-cli
starter-structure-cli my-app

If you run npm install starter-structure-cli, npm only installs the CLI package into the current folder. It does not run the scaffolder automatically.

More setup details are available in docs/installation.md.

Quick Start

Interactive mode:

npx starter-structure-cli my-app

Create flow:

npm create starter-structure-cli@latest my-app

Exact template:

npx starter-structure-cli my-app --template fullstack/react-vite-ts-tailwind-express-prisma-mysql

Choose a package manager:

npx starter-structure-cli my-app --package-manager bun

Generate into a custom directory:

npx starter-structure-cli my-app --output ./apps/my-app

Stack tokens:

npx starter-structure-cli my-app react vite ts tailwind express prisma mysql

List templates:

npx starter-structure-cli --list

Check project health:

npx starter-structure-cli --doctor

Print machine-readable output:

npx starter-structure-cli --list --json
npx starter-structure-cli --doctor --json
npx starter-structure-cli my-app react vite ts --dry-run --json

Inspect one template:

npx starter-structure-cli --template-info single/react-vite-ts-tailwind
npx starter-structure-cli --template-info single/react-vite-ts-tailwind --json

Preview a match without writing files:

npx starter-structure-cli my-app react vite ts tailwind --dry-run --explain

Repository Structure

bin                 CLI entry point
lib                 Template build helpers
packages            Companion publishable packages like npm create wrappers
scripts             Build, validation, stats, and publish utilities
template-sources    Bases, layers, presets, and reusable components
templates           Generated templates used by the CLI
docs                Public project documentation

Documentation

• Installation
• CLI Guide
• Architecture
• Templates
• Publishing
• Roadmap
• Contributing

Local Development

Useful commands:

npm install
npm run build:architecture-stubs
npm run build:templates
npm run check:create-package
npm run check:templates
node ./bin/starter-structure-cli.js --list
node ./bin/starter-structure-cli.js my-app react vite ts --dry-run --explain

For template changes, update template-sources/ first and then rebuild templates/.

Usage Stats

npm does not provide unique user counts, but download counts are available:

npm run stats:downloads

Links

• GitHub: https://github.com/mohosin2126/starter-structure-cli
• Issues: https://github.com/mohosin2126/starter-structure-cli/issues

License

MIT