Estilização e Performance de UI
Prioridade: P1 (ALTA)
Priorize Zero-Runtime CSS para Componentes de Servidor.
Seleção de Bibliotecas
| Biblioteca | Veredito | Motivo |
|---|---|---|
| Tailwind / shadcn | Preferido (P1) | Zero-runtime, compatível com RSC. Melhor para App Router. |
| CSS Modules / SCSS | Recomendado | Escopado, zero-runtime. Bom para projetos legados. |
| Ant Design | Suportado | Use com wrappers de Componente Cliente para RSCs. |
| MUI / Chakra (Runtime) | Evite | Força o uso amplo de use client. Degrada a performance. |
Padrões de Bibliotecas
Para configurações específicas de bibliotecas, veja:
- references/scss.md
- references/ant-design.md
- references/tailwind.md (Tailwind/shadcn)
Padrões
- Classes Dinâmicas: Use
clsx+tailwind-merge(utilitáriocn).- Referência: Classes Dinâmicas e Exemplo de Botão
- Otimização de Fontes: Use
next/fontpara prevenir Mudança Cumulativa de Layout (CLS).- Referência: Configuração de Fontes
- Prevenção de CLS: Sempre especifique
width/heightem imagens.
Anti-Padrões
- Nenhum runtime CSS-in-JS com RSC: MUI/Chakra forçam
'use client'; prefira Tailwind ou CSS Modules. - Nenhum
<img>sem dimensões: Sempre definawidth/heightou usefillpara prevenir CLS. - Nenhuma classe condicional hardcoded: Use
clsx+tailwind-merge(cn) para estilos dinâmicos. - Nenhuma tag
<link>do Google Fonts: Usenext/fontpara fontes auto-hospedadas sem CLS.