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 20 or later for the CLI. Nuxt and SvelteKit projects require Node.js 22.22.2 or later. Run one of the commands below from the directory that should contain the new project.

bash

npm create fsd-architecture@latest

bash

npx create-fsd-architecture@latest

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

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.

bash

cd my-app
npm install
npm run dev