Project scaffolding
Create a complete FSD project
The interactive wizard creates a framework starter, configures the selected frontend stack, and keeps every FSD layer available from day one.
اقرأ دليل البدء السريع بالعربية
Requirements
Use Node.js 22.12.0 or later for the CLI. Nuxt and SvelteKit projects require Node.js 22.22.2 or later. See Compatibility for the exact range of each framework and package manager. Run one of the commands below from the directory that should contain the new project.
npm create fsd-architecture@latestThe wizard then asks which package manager the new project should use; pass --package-manager pnpm, yarn, or bun to skip that question. To run a single command without installing, use your manager's one-off runner:
npx create-fsd-architecture@latest -g entity productSince CLI 2.7.1 you can install it once and use the shorter fsd command, which is the same CLI.
npm install -g create-fsd-architecturefsd create my-app
fsd g entity productWindows, macOS, and Linux
Every release is tested on Windows, macOS, and Linux: the CLI test suite, a global install, and a create, generate, and inspect smoke run on each. Package managers are tested with npm, pnpm, Yarn, and Bun. Commands in these docs work unchanged in PowerShell and Command Prompt, except inline environment variables, which use POSIX shell syntax:
# macOS / Linux / Git Bash
FSD_PRE_COMMIT_LINT=1 git commit -m "feat: add catalog"
# PowerShell
$env:FSD_PRE_COMMIT_LINT = "1"; git commit -m "feat: add catalog"; Remove-Item Env:FSD_PRE_COMMIT_LINTUse forward slashes in nested project names, such as apps/web; the CLI rejects backslashes so paths behave the same on every system.
Pass the project name directly
Supplying a folder name skips only the name prompt. The wizard still asks for the framework and stack choices.
npx create-fsd-architecture@latest my-appChoose a framework from the command line
Use --framework for repeatable setup. Add --yesto accept that framework's default stack, not React defaults.
npx create-fsd-architecture@latest my-react-app --framework react-vite --yes
npx create-fsd-architecture@latest my-next-app --framework nextjs --yes
npx create-fsd-architecture@latest my-vue-app --framework vue-vite --yes
npx create-fsd-architecture@latest my-nuxt-app --framework nuxt --yes
npx create-fsd-architecture@latest my-svelte-app --framework sveltekit --yesnpx create-fsd-architecture@latest --list-templatesWhat the wizard does
- 1Choose a project name and starter: React + Vite, Next.js, Vue + Vite, Nuxt, or SvelteKit.
- 2Choose the framework-compatible API, server-state, client-state, and forms stack.
- 3Choose npm, pnpm, Yarn, or Bun as the package manager.
- 4Download the matching starter and write the complete FSD structure.
- 5Save the selected stack in fsd.config.json and initialize a fresh Git repository.
- 6Optionally install dependencies, verify Commitlint, and start the development server.
React + Vite
A client-side React starter with Vite, TypeScript, Tailwind CSS, ESLint, Steiger, Git hooks, and the full FSD layer structure.
Next.js
An App Router starter with React Compiler, TypeScript, Tailwind CSS, Biome, Steiger, Git hooks, and FSD route compositions.
Vue + Vite
A Vue 3 starter with Vite, TypeScript, Tailwind CSS, Pinia, TanStack Vue Query, VeeValidate + Zod, ESLint, and Steiger.
Nuxt
A Nuxt 4 SSR starter with the official app directory, native Fetch, Pinia, Vue Query hydration, VeeValidate + Zod, and file-based route wrappers for FSD pages.
SvelteKit
A Svelte 5 and SvelteKit 2 SSR starter with native Fetch, TanStack Svelte Query, Svelte stores, Superforms + Zod, and generated route wrappers that compose FSD page slices.
Continue manually
If you skip installation or starting the server, the CLI prints the matching commands for the package manager you selected.
cd my-app
npm install
npm run dev