Краткое руководство
Начните проект с архитектурой 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 или новее. Проверьте установленную версию:
node --versionСоздание проекта
Выполните команду из папки, в которой хотите создать проект, и выберите фреймворк, инструменты состояния и шаблоны в интерактивном мастере:
npx create-fsd-architecture@latest my-appИли примите настройки по умолчанию сразу, указав фреймворк:
npx create-fsd-architecture@latest my-app --framework react-vite --yesГенерация срезов
Из корня проекта генератор читает файл fsd.config.json и создаёт файлы под ваш фреймворк. Используйте --dry-run, чтобы предварительно просмотреть файлы:
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, и другие слои импортируют из среза только через него.
Безопасное обновление
Установка более новой версии инструмента не меняет ваш проект автоматически. Сначала просмотрите план обновления, а затем примените его, когда в нём нет конфликтов:
npx create-fsd-architecture@latest upgrade --dry-run
npx create-fsd-architecture@latest upgrade --yesСледующие шаги
- Файл конфигурации fsd.config.json (на английском)
- Руководство по генератору срезов (на английском)
- Подробнее о безопасном обновлении (на английском)