Início rápido
Coloque um projeto com arquitetura FSD no ar em minutos
O FSD CLI é uma ferramenta de linha de comando que cria projetos de React, Next.js, Vue, Nuxt ou SvelteKit com uma estrutura completa de Feature-Sliced Design, e gera slices (features, entities, widgets, pages) à medida que o projeto cresce. O restante da documentação está disponível apenas em inglês por enquanto.
Requisitos
Você precisa do Node.js 22.12.0 ou posterior. Os projetos de Nuxt e SvelteKit precisam do Node.js 22.22.2 ou posterior. Verifique a versão instalada:
node --versionCriar um projeto
Execute o comando no diretório onde você quer criar o projeto e escolha o framework, o gerenciamento de estado e o template no assistente interativo:
npx create-fsd-architecture@latest my-appOu aceite diretamente a configuração padrão informando o framework:
npx create-fsd-architecture@latest my-app --framework react-vite --yesGerar slices
Na raiz do projeto, o gerador lê o arquivo fsd.config.json e cria os arquivos para o seu framework. Use --dry-run para ver primeiro uma prévia dos arquivos:
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 ganha um arquivo index.ts: sua API pública, a única forma pela qual outras camadas podem importar a partir do slice.
Atualizações seguras
Instalar uma versão mais recente da ferramenta não altera o seu projeto automaticamente. Revise primeiro o plano de atualização e confirme que não há conflitos antes de aplicá-lo:
npx create-fsd-architecture@latest upgrade --dry-run
npx create-fsd-architecture@latest upgrade --yesPróximos passos
- Arquivo de configuração fsd.config.json (em inglês)
- Guia do gerador de slices (em inglês)
- Saiba mais sobre as atualizações seguras (em inglês)