UI de Linha de Base
Impõe uma linha de base UI opinativa para evitar a 'sujeira' de interface gerada por IA.
Como usar
-
/baseline-uiAplica essas restrições a qualquer trabalho de UI nesta conversa. -
/baseline-ui <arquivo>Revisa o arquivo contra todas as restrições abaixo e gera:- violações (cite a linha/trecho exato)
- por que é importante (1 frase curta)
- uma correção concreta (sugestão em nível de código)
Pilha
- DEVE usar os padrões do Tailwind CSS, a menos que valores personalizados já existam ou sejam explicitamente solicitados
- DEVE usar
motion/react(anteriormenteframer-motion) quando animação JavaScript for necessária - DEVE usar
tw-animate-csspara animações de entrada e microanimações no Tailwind CSS - DEVE usar o utilitário
cn(clsx+tailwind-merge) para lógica de classes
Componentes
- DEVE usar primitivos de componente acessíveis para qualquer coisa com comportamento de teclado ou foco (
Base UI,React Aria,Radix) - DEVE usar primeiro os primitivos de componente existentes do projeto
- NUNCA misturar sistemas de primitivos na mesma superfície de interação
- DEVE preferir
Base UIpara novos primitivos, se for compatível com a pilha - DEVE adicionar um
aria-labela botões somente com ícone - NUNCA reconstruir comportamento de teclado ou foco manualmente, a menos que seja explicitamente solicitado
Interação
- DEVE usar um
AlertDialogpara ações destrutivas ou irreversíveis - DEVE usar esqueletos estruturais para estados de carregamento
- NUNCA usar
h-screen, useh-dvh - DEVE respeitar
safe-area-insetpara elementos fixos - DEVE mostrar erros próximos aonde a ação acontece
- NUNCA bloquear colagem em elementos
inputoutextarea
Animação
- NUNCA adicionar animação a menos que seja explicitamente solicitada
- DEVE animar apenas props do compositor (
transform,opacity) - NUNCA animar propriedades de layout (
width,height,top,left,margin,padding) - DEVE evitar animar propriedades de pintura (
background,color), exceto para pequenas partes locais da UI (texto, ícones) - DEVE usar
ease-outna entrada - NUNCA exceder
200mspara feedback de interação - DEVE pausar animações em loop quando fora da tela
- DEVE respeitar
prefers-reduced-motion - NUNCA introduzir curvas de easing personalizadas, a menos que sejam explicitamente solicitadas
- DEVE evitar animar imagens grandes ou superfícies em tela cheia
Tipografia
- DEVE usar
text-balancepara títulos etext-prettypara corpo/parágrafos - DEVE usar
tabular-numspara dados - DEVE usar
truncateouline-clamppara UI densa - NUNCA modificar
letter-spacing(tracking-*) a menos que seja explicitamente solicitado
Layout
- DEVE usar uma escala fixa de
z-index(semz-*arbitrário) - DEVE usar
size-*para elementos quadrados em vez dew-*+h-*
Performance
- NUNCA animar superfícies grandes com
blur()oubackdrop-filter - NUNCA aplicar
will-changefora de uma animação ativa - NUNCA usar
useEffectpara algo que possa ser expresso como lógica de renderização
Design
- NUNCA usar gradientes a menos que sejam explicitamente solicitados
- NUNCA usar roxo ou gradientes multicoloridos
- NUNCA usar efeitos de brilho como principal recurso de destaque
- DEVE usar a escala de sombra padrão do Tailwind CSS, a menos que seja explicitamente solicitado
- DEVE fornecer aos estados vazios uma ação clara de próximo passo
- DEVE limitar o uso de cor de destaque a uma por visualização
- DEVE usar tema existente ou tokens de cor do Tailwind CSS antes de introduzir novos