Inicio rápido
Pon en marcha un proyecto con arquitectura FSD en minutos
FSD CLI es una herramienta de línea de comandos que crea proyectos de React, Next.js, Vue, Nuxt o SvelteKit con una estructura completa de Feature-Sliced Design, y genera slices (features, entities, widgets, pages) a medida que el proyecto crece. El resto de la documentación está disponible solo en inglés por ahora.
Requisitos
Necesitas Node.js 22.12.0 o una versión posterior. Los proyectos de Nuxt y SvelteKit necesitan Node.js 22.22.2 o una versión posterior. Comprueba la versión instalada:
node --versionCrear un proyecto
Ejecuta el comando en el directorio donde quieras crear el proyecto y elige el framework, la gestión de estado y la plantilla en el asistente interactivo:
npx create-fsd-architecture@latest my-appO acepta directamente la configuración predeterminada indicando el framework:
npx create-fsd-architecture@latest my-app --framework react-vite --yesGenerar slices
En la raíz del proyecto, el generador lee el archivo fsd.config.json y crea los archivos para tu framework. Usa --dry-run para ver primero una vista previa de los archivos:
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 catalogCada slice obtiene un archivo index.ts: su API pública, la única vía por la que otras capas pueden importar desde el slice.
Actualizaciones seguras
Instalar una versión más reciente de la herramienta no cambia tu proyecto automáticamente. Revisa primero el plan de actualización y confirma que no hay conflictos antes de aplicarlo:
npx create-fsd-architecture@latest upgrade --dry-run
npx create-fsd-architecture@latest upgrade --yesSiguientes pasos
- Archivo de configuración fsd.config.json (en inglés)
- Guía del generador de slices (en inglés)
- Más información sobre las actualizaciones seguras (en inglés)