Skip to content

Read in English

Краткое руководство

Начните проект с архитектурой FSD за несколько минут

FSD CLI — это инструмент командной строки, который создаёт проект React, Next.js, Vue, Nuxt или SvelteKit с полной структурой Feature-Sliced Design, а затем генерирует срезы (features, entities, widgets, pages) по мере роста проекта. Остальная документация пока доступна только на английском.

Требования

Требуется Node.js 22.12.0 или новее. Проекты Nuxt и SvelteKit требуют 22.22.2 или новее. Проверьте установленную версию:

bash
node --version

Создание проекта

Выполните команду из папки, в которой хотите создать проект, и выберите фреймворк, инструменты состояния и шаблоны в интерактивном мастере:

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

Или примите настройки по умолчанию сразу, указав фреймворк:

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

Генерация срезов

Из корня проекта генератор читает файл fsd.config.json и создаёт файлы под ваш фреймворк. Используйте --dry-run, чтобы предварительно просмотреть файлы:

bash
npx create-fsd-architecture@latest -g entity product --dry-run
npx create-fsd-architecture@latest -g feature cart
npx create-fsd-architecture@latest -g widget navbar
npx create-fsd-architecture@latest -g page catalog

Каждый срез получает файл index.ts — его публичный API, и другие слои импортируют из среза только через него.

Безопасное обновление

Установка более новой версии инструмента не меняет ваш проект автоматически. Сначала просмотрите план обновления, а затем примените его, когда в нём нет конфликтов:

bash
npx create-fsd-architecture@latest upgrade --dry-run
npx create-fsd-architecture@latest upgrade --yes

Следующие шаги

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

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