Skip to content

Read in English

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:

bash
node --version

Criar 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:

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

Ou aceite diretamente a configuração padrão informando o framework:

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

Gerar 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:

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

Cada 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:

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

Próximos passos

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

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