UI design: regras para construir interfaces
Estas regras foram destiladas do livro UI Design Principles de Michael Filipiuk (edição de 2021). Este arquivo contém as regras que se aplicam a toda tela. references/ (ao lado deste arquivo) contém os detalhes, um arquivo por tópico; leia apenas os arquivos que sua tarefa tocar.
Regras sem uma tag vêm do livro. (WCAG) marca um padrão de acessibilidade que o livro não menciona. (convention) marca um valor comum da indústria adicionado para preencher uma lacuna. (derived) marca um valor calculado com o próprio método do livro. 1 pt no livro = 1 CSS px = 1 iOS pt = 1 Android dp.
O sistema de design do repositório vence
Se o repositório já possui tokens ou um tema (um config do Tailwind, variáveis CSS, um tema shadcn/MUI, uma biblioteca components/ui/), use-os. Esta skill apenas preenche o que eles não definem.
- Nunca introduza um segundo conjunto de tokens ao lado dos do próprio repositório.
- Reutilize um componente existente em vez de construir um paralelo.
- Quando o próprio repositório quebrar uma das regras abaixo (um contraste que falha, um botão de 32 px), mantenha o valor do repositório e reporte o conflito. Não o substitua silenciosamente.
Prioridade quando as regras entram em conflito: usabilidade > acessibilidade > consistência > simplicidade > aparência.
Caminho rápido
- Personalidade primeiro: lúdico, neutro ou sério, com base na marca e no público (
references/personality-and-copy.md). Nunca seu próprio gosto. - Tokens antes das telas: cores, escala tipográfica e escala de espaçamento, do repositório ou de
references/tokens.md. Não use nada fora deles. - Escala de cinza primeiro: acerte hierarquia, layout e espaçamento, depois adicione cor apenas onde ela tem uma função.
- Componentes com todos os estados (padrão, hover, pressionado, foco, desabilitado, erro, sucesso), e todos os estados de tela (vazio, carregando, erro, 404).
- Antes de relatar como concluído: percorra
references/checklist.mdpara o que você construiu. Se puder tirar um screenshot, verifique o screenshot, não o código.
Inegociáveis
- O espaçamento vem da escala. Use uma escala de 4 pt no mobile e uma escala de 8 pt na web. Sem valores de 5, 13 ou 22 px.
- O texto do corpo é de 16–17 px. Nunca vá abaixo de 10 px para qualquer texto e prefira 12 px ou mais. Nunca use um peso Light em texto pequeno.
- Uma única família tipográfica, uma sans serif por padrão. Use cerca de 5 tamanhos.
- Nunca use
#000000para texto ou sombras. Use um cinza escuro matizado como#1F1F1F. - Uma cor primária, aplicada apenas ao que deve se destacar. Se tudo se destaca, nada se destaca.
- Contraste: 4.5:1 para texto do corpo e 3:1 para texto grande e partes da UI (WCAG).
- Nunca use apenas cor para transmitir significado. Erros, mensagens de sucesso e links também recebem um ícone, texto, peso ou um sublinhado.
- Cada alvo de toque ou clique tem pelo menos 44×44, mesmo quando o glifo visível é menor.
- Botões têm 40–60 px de altura, com um botão primário por grupo. Quando os botões vêm em pares, o primário vai para a direita. O rótulo diz exatamente o que acontece.
- Entradas sempre têm um rótulo visível. Um placeholder sozinho não é um rótulo. Use um formulário de coluna única com validação inline e nunca apague o que o usuário digitou.
- As sombras são suaves (grande deslocamento Y, grande desfoque, 5–10% de opacidade) e apenas em elementos interativos ou elevados.
- Ícones vêm de um único pacote, em um único estilo, com a mesma espessura de traço e arredondamento. Ícones que não são universalmente conhecidos recebem um rótulo.
- Animações dão feedback, duram menos de 1000 ms e são suavizadas (nunca lineares).
- Sem Lorem Ipsum. Escreva texto real, curto e humano. Erros dizem como corrigir o problema. Diálogos nomeiam o objeto e a consequência.
- Mesma coisa, mesma aparência, mesmo comportamento em todas as telas. Siga os padrões da plataforma para comportamento.
Qual referência ler
| A tarefa toca | Leia |
|---|---|
| Um novo projeto ou tema, escolhendo valores | tokens.md (espaçamento, escala tipográfica, papéis de cor, raio, sombra, animação, CSS inicial) |
| Uma página ou layout de tela, grade, espaçamento, hierarquia | layout.md |
| Estilos de texto, cabeçalhos, parágrafos | typography.md |
| Paleta, modo escuro, sombras, gradientes | color-and-depth.md |
| Botões e CTAs | buttons.md |
| Formulários, entradas, selects, checkboxes, validação | forms.md |
| Cartões, listas de itens | cards.md |
| Ícones | icons.md |
| Barra de abas, navegação superior, barra lateral, links | navigation.md |
| Fotos, ilustrações, arte de estado vazio e 404 | imagery.md |
| Sensação da marca, rótulos de botões, diálogos, erros, tom | personality-and-copy.md |
| Transições, hover, carregamento, feedback | motion.md |
| Contraste, texto alternativo, alvos, legendas | accessibility.md |
| Componentes para reutilizar, estados, telas vazias/404, um sistema de design | system-and-states.md |
| Revisando uma tela concluída | checklist.md |
Todos os caminhos estão sob a pasta references/ desta skill.