promovaweb shadcn/ui
Fluxo
- Confirmar framework, versão,
components.json, aliases, CSS e registry. - Auditar componentes já incorporados antes de adicionar novos.
- Escolher primitives pelo comportamento e semântica exigidos.
- Adicionar o menor conjunto e revisar o código gerado.
- Adaptar tokens, variantes e composição sem quebrar acessibilidade do primitive.
- Construir estados reais: loading, empty, error, disabled e permission denied.
- Testar teclado, foco, responsividade, formulário e tema.
Padrões
- Não tratar shadcn/ui como dependência opaca; o source pertence ao projeto.
- Preservar roles, labels, focus management e escape dos primitives.
- Centralizar tokens; evitar editar dezenas de componentes para trocar tema.
- Compor Data Table por caso de uso, sem inventar componente universal.
- Fazer Sidebar responder a viewport, densidade e hierarquia de navegação.
- Validar formulários no servidor e associar erros a campos.
- Atualizar componente somente após comparar diff e customizações locais.
Validação
- Typecheck, lint, testes e build.
- Navegação completa por teclado, focus trap e retorno de foco.
- Mobile/desktop, tema claro/escuro, zoom e conteúdo longo.
- Estados de tabela, gráfico, formulário, dialog e sidebar usados.
Leia references/standards.md para registry, padrões de dashboard, composição e fontes oficiais.