Skip to content

Applies to CLI v2.8.0

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.

bash
npm create fsd-architecture@latest

The 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:

bash
npx create-fsd-architecture@latest -g entity product

Since CLI 2.7.1 you can install it once and use the shorter fsd command, which is the same CLI.

bash
npm install -g create-fsd-architecture
bash
fsd create my-app
fsd g entity product

Windows, 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:

bash
# 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_LINT

Use 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.

bash
npx create-fsd-architecture@latest my-app

Choose a framework from the command line

Use --framework for repeatable setup. Add --yesto accept that framework's default stack, not React defaults.

bash
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 --yes
bash
npx create-fsd-architecture@latest --list-templates

What the wizard does

  1. 1Choose a project name and starter: React + Vite, Next.js, Vue + Vite, Nuxt, or SvelteKit.
  2. 2Choose the framework-compatible API, server-state, client-state, and forms stack.
  3. 3Choose npm, pnpm, Yarn, or Bun as the package manager.
  4. 4Download the matching starter and write the complete FSD structure.
  5. 5Save the selected stack in fsd.config.json and initialize a fresh Git repository.
  6. 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.

bash
cd my-app
npm install
npm run dev

Support FSD CLI

If FSD CLI helps you build, consider supporting its development and documentation. Donations are optional.

GitHub Sponsors (opens in a new tab)Buy Me a Coffee (opens in a new tab)

InstaPay · Egypt

ashrafmo-1

للدعم من مصر عبر إنستا باي. تأكد من بيانات المستلم قبل تأكيد التحويل.