Nomeação e consistência
Por que importa
Nomes coerentes ancoram telas, componentes e ações. Sem um padrão, fluxos quebram, props ficam ambíguas e a manutenção aumenta. Uma convenção clara facilita a leitura da DSL e garante que o time encontre rapidamente cada elemento.
Forma canônica (sintaxe mínima)
Convenções de nomes para telas e componentes
Por quê: mostra uso de PascalCase para telas e componentes, facilitando referências e reutilização.
Padrões de uso
Props nomeadas de forma descritiva
Quando usar: representar valores específicos do domínio sem abreviações obscuras. Por quê: nomes explícitos evitam dúvidas ao alimentar dados no componente.
Ações com verbos no infinitivo
Quando usar: instruir claramente o que acontece ao acionar o botão. Por quê: verbos consistentes reforçam expectativas do fluxo.
Listas com componentes semânticos
Quando usar: nomear componentes de lista com foco no domínio representado. Por quê: ajuda a mapear rapidamente a estrutura ao navegar pelo arquivo.
Erros comuns (Do/Don’t)
❌ Errado — Abreviação sem contexto
✅ Correto — Nome explícito
Por quê: nomes completos facilitam a busca e reduzem ambiguidades.
❌ Errado — Mesmo slug para telas diferentes
✅ Correto — Slugs distintos
Por quê: slugs duplicados impedem navegação correta e confundem referências.
❌ Errado — Inglês e português juntos
✅ Correto — Idioma consistente
Por quê: consistência linguística fortalece compreensão e evita traduções improvisadas.
Referências cruzadas
Relacionados
Sintaxe básica: base para declarar nomes válidos na DSL.Component Definition: reutiliza nomes de componentes bem definidos.Component Props: depende de chaves consistentes para preencher dados.Flow: garante que links apontem para slugs corretos.
Composições recomendadas
- Nomeação e consistência + Flow → conecta rotas usando slugs previsíveis.
- Nomeação e consistência + Component Composition → organiza subcomponentes sem conflitos.
- Nomeação e consistência + Error Patterns → reduz chances de criar anti-padrões por nomes confusos.
Fluxo nomeado de forma coesa
Por quê: nomes explícitos e relacionados tornam o fluxo fácil de seguir e documentar.