O que Design Tokens faz?
Um pequeno conjunto de valores nomeados, usados em todo lugar, é o que faz um site parecer projetado em vez de montado. Defina tokens antes dos componentes; alterar uma marca depois significa editar um único bloco.
O que perguntar
Uma cor de marca (ou uma palavra de humor), base clara ou escura, e o tom (corporativo, divertido, editorial, técnico). Todo o resto pode ser derivado.
Cor
Trabalhe com papéis, não com nomes de cores, para que uma reformulação da marca não exija renomeação.
| Token | Papel | Regra prática |
|---|---|---|
--bg | Fundo da página | Off-white ou quase preto, nunca #fff ou #000 puros |
--surface | Cartões, campos de entrada | 2 a 4% de diferença de --bg em luminosidade |
--text | Texto do corpo | Pelo menos 7:1 sobre --bg |
--muted | Texto secundário | Pelo menos 4.5:1 sobre --bg |
--border | Linhas finas | 10 a 15% da cor do texto misturada no fundo |
--accent | Botões, destaques | A cor da marca |
--accent-ink | Links e texto de destaque sobre --bg | A marca, escurecida (ou clareada no escuro) até passar 4.5:1 |
--on-accent | Texto sobre destaque | A cor (branco ou escuro) que passar 4.5:1 |
Diretrizes:
- Tingir os neutros ligeiramente para o matiz do destaque (2 a 6% de saturação). Cinzas puros ao lado de um destaque quente parecem desconexos.
- Use o destaque em aproximadamente 10% da superfície. Se tudo for destacado, nada é.
- Raramente é necessário um segundo destaque. Adicione um apenas para um significado distinto, como sucesso ou promoção.
- Para o modo escuro, não inverta. Aumente a luminosidade da superfície conforme a elevação aumenta e reduza um pouco a saturação do destaque para que ele não brilhe.
Se a CLI webcraft estiver disponível, gere um conjunto inicial em vez de derivar valores manualmente. Ela aplica todas as regras acima, resolve a luminosidade até que cada par passe e constrói o tema escuro separadamente:
webcraft tokens "#e4572e" --tone editorial -o tokens.css # também: --base dark, --radius pill
webcraft tokens "#e4572e" --format theme-json # WordPress theme.json com os mesmos valores
Dentro de um cliente MCP, a mesma coisa é a ferramenta generate_tokens. Trate a saída como um primeiro rascunho: ajuste visualmente e depois verifique novamente.
Verifique cada par de texto e fundo antes de finalizar:
webcraft contrast "#1b1b1f" "#f6f4ef"
webcraft contrast --tokens tokens.css
python scripts/contrast.py --tokens tokens.css # fallback sem instalação, apenas valores hex
A primeira forma imprime a taxa e os níveis WCAG para um par. A segunda lê um arquivo CSS e verifica os pares de papéis padrão em todos os blocos de tema (:root, [data-theme], prefers-color-scheme), resolvendo var() e lendo hex, rgb(), hsl(), oklch() e color-mix(). Pares que falham são o defeito de acessibilidade mais comum em sites novos e são invisíveis para pessoas com boa visão em um bom monitor; é por isso que isso é um script e não uma questão de julgamento.
Tipografia
- No máximo duas famílias: uma para títulos, outra para corpo. Uma única família em dois pesos geralmente é melhor.
- Combine por contraste de estrutura (serifa decorativa com corpo sem serifa, ou condensada decorativa com corpo regular), não duas sem serifas semelhantes.
- Tamanho do corpo de 16 a 18px, altura de linha de 1.5 a 1.7, comprimento de linha de 60 a 75 caracteres.
- Tipografia decorativa: altura de linha de 0.95 a 1.1, espaçamento negativo que cresce com o tamanho.
- Escala fluida com
clamp()para que não haja saltos entre pontos de quebra:
:root {
--step--1: clamp(0.83rem, 0.8rem + 0.15vw, 0.9rem);
--step-0: clamp(1rem, 0.95rem + 0.25vw, 1.125rem);
--step-1: clamp(1.25rem, 1.1rem + 0.6vw, 1.6rem);
--step-2: clamp(1.6rem, 1.3rem + 1.3vw, 2.4rem);
--step-3: clamp(2rem, 1.5rem + 2.6vw, 3.6rem);
--step-4: clamp(2.5rem, 1.6rem + 4.6vw, 5.5rem);
--step-5: clamp(3rem, 1.5rem + 7vw, 7.5rem);
}
- Carregue fontes com
font-display: swap, pré-carregue os um ou dois arquivos usados acima da dobra e subconjunte se estiver hospedando localmente.
Espaçamento, cantos arredondados, sombra
:root {
--space-1: 0.25rem; --space-2: 0.5rem; --space-3: 0.75rem; --space-4: 1rem;
--space-6: 1.5rem; --space-8: 2rem; --space-12: 3rem; --space-16: 4rem;
--section: clamp(4rem, 3rem + 6vw, 9rem); /* preenchimento vertical entre seções */
--gutter: clamp(1rem, 0.5rem + 3vw, 3rem); /* preenchimento lateral da página */
--container: 76rem;
--radius-sm: 8px; --radius: 16px; --radius-lg: 28px; --radius-pill: 999px;
--shadow: 0 1px 2px rgb(0 0 0 / .04), 0 8px 24px rgb(0 0 0 / .06);
}
- Escolha uma personalidade de canto (afiado, suave ou pílula) e mantenha-a. Cantos misturados são a maneira mais rápida de parecer inconsistente.
- O espaçamento entre seções deve ser claramente maior do que o espaçamento dentro delas; essa diferença é o que diz ao olho onde uma seção termina.
Saída
Entregue um tokens.css com um bloco :root, um bloco opcional [data-theme="dark"] e uma pequena tabela de qual token é usado onde. Em seguida, declare os resultados de contraste para o texto do corpo, texto secundário e texto do botão.
Reformulando a marca de um site existente
Mapeie primeiro os valores codificados existentes para papéis (pesquise o CSS por códigos hex e conte as ocorrências), substitua-os por tokens, verifique se nada mudou visualmente e, em seguida, troque os valores dos tokens. Fazer ambos ao mesmo tempo torna impossível rastrear regressões.