Detalhes que tornam as interfaces melhores
Grandes interfaces raramente vêm de uma única coisa. Geralmente é uma coleção de pequenos detalhes que se acumulam em uma ótima experiência. Aplique estes princípios ao construir ou revisar código de UI.
Ao revisar, desacelere a interface: reproduza a animação a 10% da velocidade no painel de Animações do navegador e percorra cada estado: hover, foco, ativo, carregamento, vazio. O que parece estranho a 10% da velocidade é o que está sutilmente errado em velocidade total.
Preserve a biblioteca de componentes, tokens e densidade do projeto. Corresponda à linguagem de movimento estabelecida, exceto onde um princípio abaixo prescreve um padrão de interação exato.
Tipografia (quebra de texto, renderização de fonte, números tabulares, espaçamento) é coberta pelo skill better-typography; use-o para qualquer coisa relacionada a texto. Acessibilidade (áreas de toque, estados de foco, suporte a teclado, ARIA, movimento reduzido) é coberta pelo skill better-accessibility. Estrutura de layout (agrupamento, espaçamento entre seções, breakpoints, RTL espacial) é coberta pelo skill better-layout.
Referência Rápida
| Categoria | Quando Usar |
|---|---|
| Superfícies | Raio de borda, alinhamento óptico, sombras, contornos de imagem |
| Animações | Animações interrompíveis, transições de entrada/saída, animações de ícones, escala ao pressionar, contenção de movimento |
| Ícones | Peso do traço do ícone, estados via currentColor, contorno vs preenchimento, dimensionamento, espelhamento RTL |
| Desempenho | Especificidade de transição, uso de will-change |
Princípios Centrais
1. Raio de Borda Concêntrico
Raio externo = raio interno + padding. Raios incompatíveis em elementos aninhados é a coisa mais comum que faz as interfaces parecerem estranhas.
2. Alinhamento Óptico sobre Geométrico
Quando o centralização geométrica parece estranha, alinhe opticamente. Botões com ícones, triângulos de reprodução e ícones assimétricos precisam de ajuste manual.
3. Sombras para Elevação, Bordas para Estrutura
Para botões, cards e contêineres cuja borda existe apenas para criar profundidade, prefira valores de box-shadow transparentes em camadas. Mantenha bordas que comunicam estrutura ou estado: divisores, separadores de layout e estados selecionados ou de foco.
4. Animações Interrompíveis
Use transições CSS para mudanças de estado interativas: elas podem ser interrompidas no meio da animação. Reserve keyframes para sequências encenadas que são executadas uma vez.
5. Dividir e Escalonar Animações de Entrada
Para uma entrada encenada pouco frequente onde a sequência ajuda a comunicar hierarquia, divida o conteúdo em blocos semânticos e os escale com ~100ms de diferença em vez de animar um contêiner. Não escale interações rotineiras e de alta frequência.
6. Animações de Saída Sutil
Use um pequeno translateY fixo em vez de altura total. As saídas devem ser mais suaves que as entradas. Use ease-out para transições de entrada e saída.
7. Animações de Ícones Contextuais
Anime ícones com opacity, scale e blur em vez de alternar visibilidade. Use exatamente estes valores: escala de 0.25 a 1, opacidade de 0 a 1, blur de 4px a 0px. Se o projeto tiver motion ou framer-motion no package.json, corresponda ao caminho de importação desse pacote (ou as importações próximas estabelecidas quando ambos existirem) e use transition: { type: "spring", duration: 0.3, bounce: 0 }; bounce deve ser sempre 0. Se nenhuma biblioteca de movimento estiver instalada, mantenha ambos os ícones no DOM (um posicionado absolutamente) e faça cross-fade com transições CSS usando cubic-bezier(0.2, 0, 0, 1); isso fornece animações de entrada e saída sem qualquer dependência.
8. Contornos de Imagem
Adicione um contorno sutil de 1px com baixa opacidade às imagens para profundidade consistente. A cor deve ser preto puro no modo claro (oklch(0 0 0 / 0.1)) e branco puro no modo escuro (oklch(1 0 0 / 0.1)), nunca um quase preto como slate, zinco ou qualquer neutro matizado. Um contorno matizado capta a cor da superfície abaixo e parece sujeira na borda da imagem.
9. Escala ao Pressionar
Um sutil scale(0.96) ao clicar dá feedback tátil aos botões. Sempre use 0.96. Nunca use um valor menor que 0.95: qualquer coisa abaixo parece exagerada. Adicione uma prop static para desabilitá-lo quando o movimento for perturbador.
10. Pular Animação no Carregamento da Página
Use initial={false} no AnimatePresence para evitar animações de entrada na primeira renderização. Verifique se não quebra animações de entrada intencionais.
11. Nunca Use transition: all
Sempre especifique propriedades exatas: transition-property: scale, opacity. O transition-transform do Tailwind cobre transform, translate, scale, rotate.
12. Use will-change com Moderação
Apenas para transform, opacity, filter, as propriedades que a GPU pode compor. Nunca use will-change: all. Adicione apenas quando notar trepidação no primeiro quadro.
13. Corresponder Peso do Traço do Ícone ao Peso do Texto
Um ícone ao lado de texto carrega o peso óptico do texto: traço de 1.5px ao lado de texto regular (400), 2px ao lado de semibold (600). Um peso de traço por conjunto de ícones; nunca misture bibliotecas em uma superfície.
14. Um SVG, Recolorido por Estado
Ícones usam currentColor e obtêm seus estados (hover, selecionado, desabilitado) de cor e opacidade CSS, nunca de assets separados. A variante de contorno é o padrão; a variante de preenchimento marca o estado ativo.
15. Contenção de Movimento
Nenhuma animação personalizada em interações de alta frequência: o custo de atenção se repete a cada acionador. Movimento nunca é o único canal de feedback; toda mudança de estado animada também precisa de uma dica estática (cor, ícone, rótulo).
Erros Comuns
| Erro | Correção |
|---|---|
| Mesmo raio de borda em pai e filho muito aninhados | Calcule raioExterno = raioInterno + padding |
| Ícones parecem descentralizados | Ajuste opticamente com padding ou corrija o SVG diretamente |
| Borda usada apenas para simular elevação | Use box-shadow em camadas com transparência; mantenha bordas estruturais e de estado |
| Entrada encenada ou saída contextual brusca | Escalone entradas pouco frequentes e mantenha saídas contextuais sutis |
| Ícone com estado ou alternância anima seu estado padrão no carregamento da página | Adicione initial={false} ao AnimatePresence correspondente; preserve entradas de página intencionais |
transition: all em elementos | Especifique propriedades exatas |
| Trepidação de animação no primeiro quadro | Adicione will-change: transform (com moderação) |
| Ícone de traço fino ao lado de texto em negrito | Corresponda a largura do traço ao peso do texto |
| Assets de ícone separados por estado | Um SVG com currentColor, estados via CSS |
| Ícones preenchidos em todos os lugares | Contorno como padrão, preenchimento apenas para o estado ativo |
| Animação de entrada em cada hover ou tecla | Feedback instantâneo ou transição de opacidade/cor de ≤150ms |
Formato de Saída da Revisão
Use este formato apenas quando o usuário solicitar uma revisão independente de polimento de UI. Quando better-interface orquestrar a revisão, forneça evidências de domínio e descobertas para esse skill e deixe que seu formato de saída, escala de gravidade, regras de consolidação, limite e veredito tenham precedência.
Apresente a revisão independente em duas partes.
Descobertas
Agrupe todas as descobertas confirmadas por princípio. Use uma tabela markdown com colunas Gravidade, Localização, Antes, Depois e Por quê. Nunca use linhas separadas "Antes:" / "Depois:".
- Gravidade:
HIGHtorna uma interação enganosa, sem resposta ou repetidamente perturbadora;MEDIUMcria um problema perceptível de acabamento ou consistência;LOWé polimento isolado. - Localização: cite
caminho/para/arquivo:linha. Se o artefato não tiver arquivos de origem, cite a tela e o componente exatos. - Antes / Depois: mostre a implementação atual e uma substituição acionável.
- Por quê: nomeie o princípio violado e explique como ele afeta a interface.
Consolide um problema sistêmico repetido em uma linha e liste todos os locais afetados. Omita princípios sem descobertas.
Exemplo
Raio de borda concêntrico
| Gravidade | Localização | Antes | Depois | Por quê |
|---|---|---|---|---|
| LOW | src/Card.tsx:28 | rounded-xl no card + rounded-xl no botão interno (p-2) | rounded-2xl no card (8 + 8 = 16), rounded-lg no botão interno | Cantos aninhados devem ser concêntricos |
| LOW | src/card.css:11 | border-radius: 16px em ambas as superfícies aninhadas | Externa 24px, interna 16px com 8px de padding | Raios aninhados iguais fazem a superfície interna parecer comprimida |
Escala ao pressionar
| Gravidade | Localização | Antes | Depois | Por quê |
|---|---|---|---|---|
| LOW | src/Button.tsx:19 | <button className="..."> | Adicione active:scale-[0.96] transition-transform | Feedback de pressionar torna o controle responsivo |
| MEDIUM | src/button.css:24 | scale(0.9) ao pressionar | Aumente para scale(0.96) | Qualquer valor abaixo de 0.95 parece exagerado |
Verificação e Veredito
Após as descobertas:
- Verificação: liste as verificações exatas executadas e seus resultados observados. Percorra cada estado relevante e inspecione o movimento a 10% da velocidade quando a animação estiver envolvida. Se uma verificação não foi executada, declare o que ainda precisa de verificação.
- Veredito:
Bloquearse qualquer descobertaHIGHpermanecer,Precisa de mudançasse apenas descobertasMEDIUMouLOWpermanecerem, eAprovarapenas quando nenhuma descoberta acionável permanecer.
Quando não houver descobertas, omita as tabelas, declare "Nenhuma descoberta acionável de polimento de UI", reporte a verificação e termine com Aprovar.