create-vite-reactstack

Interactive CLI to scaffold a Vite + React + TypeScript app with optional Tailwind CSS v4, shadcn/ui, React Compiler, icon libraries, React Router, TanStack Query, and your choice of linter.

Usage

npx create-vite-reactstack
# or
npm create vite-reactstack

You can pass a project name:

npx create-vite-reactstack my-app

Pass . to scaffold in place into the current directory. Nothing is ever deleted — scaffolded files are added, and only the files the scaffold itself owns are overwritten:

npx create-vite-reactstack .

You can also pass a relative path to scaffold into a nested directory (the last segment becomes the package name):

npx create-vite-reactstack apps/my-app

What it asks

Run without option flags and it walks you through:

1. Project name
2. TypeScript or JavaScript (JavaScript is gently overridden — TypeScript only)
3. React Compiler (optional)
4. Tailwind CSS
5. Icon library (none / Lucide / Phosphor / Heroicons)
6. shadcn/ui (requires Tailwind)
7. React Router
8. TanStack Query
9. Linter (Biome / ESLint / Oxlint)
10. Initialize git (includes an initial commit)
11. Package manager (npm / pnpm / yarn / bun)

Then it scaffolds the project, optionally initializes git, installs dependencies, and prints next steps.

CLI flags

Every prompt can be answered with a flag — and passing any option flag makes the run non-interactive: explicit flags win and every option you didn't set falls back to its default, no questions asked. Run without option flags for the full interactive prompt, or pass --yes to accept all defaults.

Flag	Description
-y, --yes	Use defaults for every option not set by a flag (skips all prompts)
--compiler / --no-compiler	Enable / disable React Compiler
--tailwind / --no-tailwind	Enable / disable Tailwind CSS v4
--shadcn / --no-shadcn	Enable / disable shadcn/ui (requires Tailwind)
--router / --no-router	Add / skip React Router
--query / --no-query	Add / skip TanStack Query
--linter <name>	biome | eslint | oxlint
--icons <name>	none | lucide | phosphor | heroicons
--git / --no-git	Initialize / skip the git repository
--pm <name>	npm | pnpm | yarn | bun (alias: --package-manager)
--skip-install	Don't install dependencies
-h, --help	Show help
-v, --version	Show version

Both --flag value and --flag=value work. Unknown flags are reported and ignored instead of being silently swallowed. Invalid values are rejected with an error.

Examples

npx create-vite-reactstack my-app --yes
npx create-vite-reactstack my-app --compiler --linter eslint --no-git
npx create-vite-reactstack my-app --yes --no-tailwind --skip-install
npx create-vite-reactstack . --yes --pm pnpm

Defaults used by --yes

Option	Default
React Compiler	off
Tailwind CSS	on
Icon library	lucide
shadcn/ui	on
React Router	off
TanStack Query	off
Linter	biome
Git	on
Package manager	detected from how you invoked the CLI (npm_config_user_agent)

Notes

• Choosing ESLint pins TypeScript to ~6.0 in the generated project, because typescript-eslint does not support TypeScript 7 yet.
• Choosing pnpm writes a pnpm-workspace.yaml with an allowBuilds list so native postinstall builds (esbuild, Biome) aren't blocked by pnpm 10+.

Local development

pnpm install
pnpm build
pnpm start          # runs the CLI
# or
node dist/index.js my-app

pnpm typecheck      # tsc --noEmit
pnpm smoke          # scaffold all matrix combos + assert the output
pnpm smoke:full     # also install, build and lint the e2e projects

License

MIT