Skip to content

Applies to CLI v2.8.0

Stable in CLI 2.3.0

Vue + Vite, with the full FSD workflow

The Vue edition is a first-class template, not a renamed React starter. It ships Vue-native providers, single-file components, composables, state, forms, and generators while keeping the same complete FSD layer contract as the other editions.

Create a Vue project

bash
npx create-fsd-architecture@latest my-vue-app --framework vue-vite
bash
npx create-fsd-architecture@latest my-vue-app --framework vue-vite --yes

The first command keeps stack prompts interactive. The second accepts the Vue defaults: Axios, Vue Query, Pinia, and VeeValidate + Zod.

Default stack

Framework

Vue 3 + Vite

Server state

TanStack Vue Query

Client state

Pinia

Forms

VeeValidate + Zod

Styling

Tailwind CSS 4

Quality

TypeScript, ESLint, Steiger, Husky, Commitlint

Complete architecture from day one

text
src/
├── app/          # App shell, providers, routing, and styles
├── pages/        # Route-level compositions
├── widgets/      # Large reusable UI blocks
├── features/     # User interactions and business actions
├── entities/     # Business entities and representations
└── shared/       # API, assets, config, utilities, types, and UI

Empty architectural segments remain visible through documentation placeholders, so cloning the repository does not collapse the FSD structure.

Vue-native generation

bash
npx create-fsd-architecture@latest --generate feature checkout
npx create-fsd-architecture@latest --generate entity product
npx create-fsd-architecture@latest --generate widget navbar
npx create-fsd-architecture@latest --generate page catalog
npx create-fsd-architecture@latest --generate feature auth

The CLI reads fsd.config.json and writes Vue SFCs, composables, typed API modules, Pinia stores, and VeeValidate schemas only when the selected capabilities require them. The auth command creates all five supported auth flows together.

Quality commands

bash
npm run fsd:check
npm run lint
npm run typecheck
npm run build
npm run ci

Template source

Inspect the starter, report issues, or contribute directly in its dedicated repository.

Open FSD-VUE on GitHub

What each generator writes

Output from --dry-run in a project with the Vue defaults (Axios, Vue Query, Pinia, VeeValidate + Zod). Every slice gets an index.ts public API.

text
-g feature checkout
  src/features/checkout/model/checkout.types.ts
  src/features/checkout/model/checkout.store.ts     # Pinia store
  src/features/checkout/ui/CheckoutView.vue
  src/features/checkout/api/checkout.api.ts
  src/features/checkout/api/checkout.query.ts       # Vue Query composables
  src/features/checkout/lib/checkout.keys.ts        # query keys
  src/features/checkout/lib/checkout.helpers.ts
  src/features/checkout/index.ts

-g entity product
  src/entities/product/model/product.types.ts
  src/entities/product/ui/ProductCard.vue
  src/entities/product/index.ts

-g widget product-list
  src/widgets/product-list/ui/ProductList.vue
  src/widgets/product-list/index.ts

-g page catalog
  src/pages/catalog/ui/CatalogPage.vue
  src/pages/catalog/index.ts
  src/app/routing/index.ts                          # route registered (updated)

Components are single-file components in PascalCase. Pages are added to the Vue Router config between the CLI's marker comments, so your own routes outside those markers are never touched.

Capabilities change the output

Generators read fsd.config.json and only write what the selected stack needs. With serverState: "none", features skip the API module, *.query.ts, and the query keys. With clientState: "none", they skip the Pinia store. With forms: "none", auth skips the VeeValidate + Zod schemas. Choose at creation time with flags such as --server-state none, or edit the config later; existing slices are not rewritten.

Auth in Vue

-g feature auth writes five flows (login, register, forgot password, reset password, verify code). Each gets an API module and a Zod schema, plus a LoginForm.vue-style component; the slice also shares a Pinia store, Vue Query composables, and query keys. Add --auth-provider supabase to also write the Supabase adapter (api/supabase.ts) and a SUPABASE.md setup note.

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

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