Feature-Sliced Design em monorepos: frontends que escalam

Como o FSD disciplina boundaries entre camadas e por que ele brilha quando web e mobile compartilham o mesmo domínio.

Monorepos de frontend tendem a virar um emaranhado de imports quando crescem. Você começa compartilhando um componente de botão, depois uma função de utilidade, e em pouco tempo camadas de domínio estão acopladas a camadas de UI. O Feature-Sliced Design (FSD) existe para impedir exatamente isso.

A ideia central é dividir o código em camadas com dependências unidirecionais: shared → entities → features → widgets → pages → app. Uma camada superior pode importar de uma inferior, mas nunca o contrário. Isso soa restritivo, mas é a restrição que permite refactors seguros.

Em um projeto, usamos FSD em um monorepo Yarn Workspaces com React web e React Native. As entidades de domínio — usuário, jornada de trabalho, relatório — ficaram em packages compartilhadas, enquanto features como "registrar ponto" ou "gerar relatório" tinham suas próprias slices em cada plataforma. O resultado foi que mudanças no modelo de dados se propagavam de forma previsível, sem surpresas na UI.

O maior ganho prático foi o onboarding. Novos desenvolvedores entendem rapidamente onde cada coisa mora e, mais importante, onde não devem colocar código. A arquitetura passa a ser auto-documentável.

FSD não é uma bala de prata. Para protótipos muito pequenos pode parecer burocrático. Mas quando você tem múltiplos times, múltiplas plataformas ou previsão de crescimento, ele paga o investimento inicial com juros.


Está trabalhando em algo parecido? Fale sobre o seu projeto.