Refactoring UI
Design visual não é talento. É um pequeno conjunto de decisões sistêmicas tomadas uma vez, mais um punhado de técnicas para criar hierarquia. Esta skill são esses sistemas e essas técnicas.
A maior causa única de UIs com aspecto amador é escolher valores ad hoc — 17px aqui, #3B82F6 ali, lighten(5%) para um estado de hover. Projete a partir de uma escala, sempre.
Os sistemas — use estes, não os derive novamente
Escolha a partir destas listas. Nunca invente um valor que não esteja em uma delas.
Espaçamento e dimensionamento
Base 16px, construído a partir de fatores e múltiplos dela:
4 8 12 16 24 32 48 64 96 128 192 256 384 512 640 768
Apertado na extremidade pequena, espalhando-se na extremidade grande. Nenhum dois valores adjacentes podem estar mais próximos que ~25% — é isso que torna a escolha óbvia. Uma escala linear "múltiplos de 4" falha: ela não ajuda a decidir entre 120px e 124px.
Use para margem, padding, largura, altura, tamanhos de ícone, largura de borda — tudo espacial. Fixe também um pequeno conjunto de valores de opacidade (por exemplo, .05 .1 .2 .4 .6 .8) para estados desabilitados, sobreposições e matizes de hover, em vez de ajustar um slider cada vez. Mesma lógica das outras escalas: decida uma vez, reutilize em todos os lugares.
Escala tipográfica
12 14 16 18 20 24 30 36 48 60 72
Não é uma escala modular construída a partir de uma proporção (4:5, 2:3, proporção áurea). Essas produzem valores fracionários de pixel que arredondam inconsistentemente entre navegadores e são muito esparsos para a densidade de interface — valores escolhidos a dedo, selecionados por como sentem, vencem.
Unidades: apenas px ou rem. Nunca em. em é relativo ao tamanho da fonte atual, então um .875em dentro de um pai 1.25em calcula para 17,5px — um valor que não está em sua escala. A escala silenciosamente deixa de existir.
Peso da fonte
Dois pesos são suficientes:
- 400 ou 500 — corpo e a maioria do texto da UI
- 600 ou 700 — qualquer coisa enfatizada
Nada abaixo de 400 na UI. Para desenfatizar, use uma cor mais clara ou um tamanho menor — nunca um peso mais leve.
Cor
Você precisa de muito mais cores do que um gerador de paleta de cinco amostras oferece.
- Cinzas: 8–10 tons. Quase toda uma UI é cinza — texto, fundos, painéis, bordas, controles de formulário. Três ou quatro tons sempre acabam. Comece com um cinza muito escuro, não preto verdadeiro (preto verdadeiro parece não natural).
- Primária: 5–10 tons, uma ou talvez duas primárias.
- Acentos: 5–10 tons cada — vermelho destrutivo, amarelo de aviso, verde positivo, além de qualquer outra cor que o produto precise distinguir (séries de gráficos, eventos de calendário, tags). Dez cores × 5–10 tons é normal para uma UI complexa.
Nomeie-as 100 (mais clara) → 900 (mais escura), base 500.
Construa a escala nesta ordem: escolha 500 primeiro (para uma primária/acento, deve ser um tom que funcione como fundo de botão). Depois encontre as bordas — 900 é geralmente sua cor de texto, 100 um matiz de fundo; um componente de alerta usa ambos, então projete um e leia os dois valores dele. Em seguida, preencha 700 e 300 como o compromisso perfeito entre seus vizinhos, depois 800 600 400 200 da mesma forma.
Escreva cores como HSL, não hex. hsl(220, 95%, 34%) e hsl(220, 65%, 61%) são visivelmente relacionados; #03369E e #507DD7 não são.
Nunca gere tons em tempo de execução com lighten() / darken(). É assim que se termina com 35 azuis ligeiramente diferentes.
Sombras — cinco elevações
0 1px 3px hsla(0,0%,0%,.2) /* mal levantado — botões */
0 4px 6px hsla(0,0%,0%,.2) /* dropdowns */
0 5px 15px hsla(0,0%,0%,.2)
0 10px 24px hsla(0,0%,0%,.2)
0 15px 35px hsla(0,0%,0%,.2) /* modais */
Escolha perguntando onde no eixo z isso se senta?, não qual sombra parece legal?. Mais próximo do usuário = mais atenção. Diminuir a sombra de um botão no :active faz parecer pressionado; aumentar a sombra de um item de lista quando é pego para arrastar e reordenar faz o oposto — lê-se como "agora acima de seus irmãos" e funciona como o próprio indicador de arrasto.
Estas cinco são o padrão e são boas em todos os lugares. references/techniques.md fornece uma versão de duas partes refinada da mesma escala — paralela, mas não valores idênticos (seu degrau superior é mais pesado). Use-a quando as sombras forem proeminentes no design; use estas quando não forem. Não misture as duas em um projeto.
Altura da linha e comprimento da linha
A altura da linha é inversamente proporcional ao tamanho da fonte e proporcional à largura da linha:
- texto pequeno / colunas largas →
1.5a2 - grandes manchetes →
1está bom
Comprimento da linha: 45–75 caracteres, ou seja, max-width: 20em–35em. Isso se aplica ao parágrafo mesmo quando o contêiner ao redor é mais largo — larguras mistas em uma área de conteúdo parecem mais polidas, não menos.
(em está correto aqui — a medida deve escalar com o texto que envolve. A regra "nunca em" tem escopo na escala tipográfica, onde em se compõe através do aninhamento. Não "corrija" isso.)
Raio de borda
Escolha um e mantenha a consistência. Raio pequeno = neutro. Raio grande = lúdico. Nenhum = sério/formal. Misturar cantos quadrados e arredondados em uma mesma interface sempre parece pior.
O procedimento
1. Comece com uma funcionalidade, não com um layout. Não projete "o app" — você não pode decidir entre navegação superior e barra lateral antes de saber o que está no produto. Projete uma peça real de funcionalidade (o formulário de busca, o compositor de mensagens) e deixe a casca emergir.
2. Detalhes vêm depois. Ignore tipos de letra, sombras e ícones no início. Trabalhe primeiro em escala de cinza — isso força a hierarquia a vir de espaçamento, contraste e tamanho, em vez de cor. Adicione cor assim que o layout funcionar.
3. Não invista demais em baixa fidelidade. Esboços, wireframes e mockups são descartáveis — ninguém pode usar uma imagem estática de um app. Eles existem para explorar ideias; abandone-os assim que a decisão for tomada e vá construir a coisa real.
4. Projete a menor versão útil, depois construa-a. Trabalhe em ciclos curtos de design→código. Não implique funcionalidade que você não está pronto para construir — uma caixa de comentários com uma zona de anexos que você não pode enviar ainda bloqueia toda a funcionalidade. Coisas boas de se ter são projetadas depois.
5. Escolha por eliminação. Ao escolher um valor de uma escala: adivinhe aquele que você acha que está certo, depois compare-o com o vizinho de cada lado. Dois estarão obviamente errados. Se uma opção externa vencer, repita a comparação com aquela como o novo meio.
6. Comece com muito espaço em branco e remova-o. Adicionar espaço até algo parar de parecer ruim lhe dá o mínimo. Começar generoso e cortar lhe dá a quantidade certa. UIs densas (dashboards) são legítimas — mas como uma decisão deliberada, não um padrão.
7. Encolha a tela. Um componente pequeno projetado em uma artboard de 1400px tende a se espalhar, porque o espaço está lá para ser preenchido. Comece em ~400px e projete o layout mobile primeiro, onde as restrições são reais — depois traga para uma tela grande e relaxe apenas o que genuinamente pareceu apertado. Você mudará menos do que espera.
Hierarquia — a técnica que faz mais trabalho
Tudo na tela se senta em uma pirâmide: primário, secundário, terciário. Quando tudo compete, a UI se lê como ruído. Isso é o que faz um design parecer "projetado" — não estilização.
Tamanho não é tudo. Apoiar-se apenas no tamanho da fonte lhe dá conteúdo primário que é muito grande e conteúdo secundário que é muito pequeno. Use peso e cor para carregar ênfase, e mantenha os tamanhos razoáveis.
Três cores de texto, no máximo:
- escuro — conteúdo primário
- cinza — conteúdo secundário
- cinza mais claro — conteúdo terciário (notas de rodapé, direitos autorais)
Todos os três carregam texto de tamanho de corpo real, então todos precisam de 4,5:1. "Cinza mais claro" significa o tom mais claro que ainda o atinge — aproximadamente o meio de uma rampa de 9 degraus, não a extremidade pálida. Os tons pálidos são apenas para estados desabilitados e texto grande.
Enfatize desenfatizando. Quando o elemento importante não se destacar e não houver mais nada a adicionar, suavize o que compete com ele. Desbote os itens de navegação inativos; diminua a cor de fundo da barra lateral para que o conteúdo principal se assente para frente.
Ações: estilize por hierarquia, não por semântica.
- Primária → sólida, alto contraste. Geralmente exatamente uma por página.
- Secundária → contorno, ou um fundo de baixo contraste.
- Terciária → estilizada como um link.
Destrutivo ≠ botão vermelho grande. Se "Excluir" não for a ação primária na página, dê a ele tratamento terciário — depois torne-o um botão primário vermelho grande dentro da caixa de diálogo de confirmação, onde ele genuinamente é a ação primária.
Rótulos são um último recurso. rótulo: valor dá a cada dado igual peso. A maioria dos dados se identifica pelo formato ($19,99, um endereço de e-mail) ou pelo contexto. Onde um rótulo é genuinamente necessário, incorpore-o ao valor ("12 restantes em estoque", não "Em estoque: 12"), ou adicione-o como conteúdo visivelmente secundário. Exceção: em páginas no estilo de ficha técnica onde os usuários escaneiam pelo rótulo, enfatize o rótulo.
Equilibre peso contra contraste. Ícones sólidos são visualmente pesados e gritarão mais alto que o texto ao lado deles — suavize sua cor para compensar. Funciona ao contrário também: quando uma borda de 1px é muito sutil em uma cor suave, mas muito agressiva quando escurecida, mantenha a cor suave e vá para 2px. Adicione peso para corrigir baixo contraste; reduza contraste para corrigir excesso de peso.
Hierarquia visual ≠ hierarquia de documento. Marcação semântica e peso visual são decisões separadas. Títulos de seção são geralmente rótulos, não manchetes — um h1 em 16px está bom, e às vezes o título deve estar visualmente oculto inteiramente porque o conteúdo fala por si.
Regras rígidas
Desviar-se delas produz uma falha específica e reconhecível.
- Nunca texto cinza em um fundo colorido. Cinza sobre branco funciona porque reduz o contraste; cinza sobre cor apenas parece sujo. Branco com opacidade reduzida parece lavado e desabilitado, e permite que padrões apareçam através dos glifos. Escolha manualmente uma cor com o matiz do fundo, ajustando saturação e luminosidade.
- Nunca
empara a escala tipográfica.pxourem. - Nunca gere tons em tempo de execução. Defina-os antecipadamente.
- Nunca use uma largura percentual para algo que não deve escalar. Barras laterais recebem larguras fixas; a área principal flexiona. Elementos recebem um
max-widthe só encolhem quando a tela é realmente menor — um cartão de login não deve ser mais largo em telas médias do que em grandes. - Nunca escale coisas proporcionalmente entre breakpoints. Elementos grandes devem encolher mais rápido que os pequenos. Uma manchete de 2.5em sentada em corpo mobile de 14px calcula para 35px — muito grande; ela deve ter 20–24px ali. Da mesma forma, o padding de um botão deve ficar proporcionalmente mais apertado à medida que o botão encolhe, não escalar com seu tamanho de fonte.
- Sempre mais espaço ao redor de um grupo do que dentro dele. Esta é a correção para "qual rótulo pertence a qual campo", listas com marcadores apertadas e cabeçalhos que parecem anexados ao parágrafo errado. Espaçamento ambíguo é um bug funcional, não apenas um feio.
- Nunca use cor como o único sinal. Adicione um ícone, uma forma ou uma dica de texto. Para gráficos, distinga séries por contraste (tons claros→escuros de uma cor) em vez de por matiz — usuários daltônicos leem luminosidade de forma confiável, matiz nem tanto.
- Mínimos de contraste: 4,5:1 para texto normal. A tolerância de 3:1 se aplica apenas a texto grande, que o WCAG define como 24px regular ou 18,66px negrito — não 18px. Assuma 4,5:1 a menos que o texto seja genuinamente grande. Quando branco-sobre-cor falhar, inverta: texto colorido escuro sobre um matiz claro (veja
references/systems.md). Separadamente, 3:1 se aplica a não-texto também (WCAG 1.4.11): se uma borda é a única coisa identificando um controle — um contorno de input, uma borda de checkbox — ela precisa de 3:1 contra seu fundo. Uma linha fina que meramente divide conteúdo não precisa. Esses são dois tokens diferentes, não um. - Nunca escale um ícone longe de seu tamanho pretendido. Um ícone de 16–24px em 48px parece grosso e sem detalhes. Coloque-o dentro de um círculo colorido.
Referências
assets/tokens.css — um conjunto inicial completo e verificado de contraste de todos os itens acima como propriedades customizadas CSS: espaçamento, tipo, pesos, largura de borda, uma escala fixa de opacidade, uma rampa de cinza frio de 9 tons, uma primária de 9 tons, três trios de acentos, cinco elevações, uma camada de papéis semânticos (--surface, --text-primary, --action…) e um bloco de modo escuro que substitui apenas esses papéis. Copie-o e reajuste os matizes em vez de derivar as escalas desta prosa. Referencie os papéis nos componentes, não nas rampas brutas — isso é o que faz o modo escuro funcionar. Cada par texto/superfície é verificado ≥4,5:1 em ambos os modos e cada borda funcional ≥3:1; os tons deliberadamente abaixo do limiar (desabilitados, divisores decorativos, o degrau apenas de texto grande) são isentos por critério e comentados inline.
Carregue estes quando o trabalho exigir:
references/systems.md— construindo uma paleta do zero: escolhendo a cor base, mantendo a saturação viva nas pontas clara e escura, rotação de matiz, cinzas quentes/frios, e as duas saídas de emergência para atingir taxas de contraste sem cor feia.references/diagnose.md— tabela de sintoma → correção. Carregue primeiro sempre que a tarefa for melhorar uma UI existente em vez de construir nova.references/techniques.md— simulação de profundidade e luz, sombras de duas partes, alinhamento de linha de base, espaçamento entre letras, saindo das formas de componentes padrão e lidando com imagens enviadas pelo usuário.