O design system deste site.
Este portfólio também é um experimento de método: um design system pequeno, escrito em código, com regras conferidas por máquina e cada decisão registrada. Foi construído com agentes de IA; a direção de design e as aprovações ficaram comigo.
- tokens de cor, tipo, espaço e movimento
- 111
- decisões registradas
- 44
- páginas testadas a cada mudança
- 18
- contraste mínimo do texto corrido, nos dois temas
- 4,5:1
Como funciona
Cinco passos, sempre na mesma ordem. Nenhum depende de memória: cada um deixa rastro no código.
-
Documento antes de tela.
Papéis de cor, escalas, componentes e estados são decididos num documento de design system, com o contraste de cada par medido.
-
Cor só em token.
Os temas claro e escuro são definidos num arquivo só. Componentes e páginas usam tokens semânticos, e uma cor escrita direto no CSS reprova a verificação.
-
Desvio vira decisão registrada.
Quando o código precisa divergir do documento, o motivo entra num registro numerado antes de ir ao ar. Hoje são 44.
-
A máquina confere.
A cada pacote de mudanças rodam as verificações de contraste, tokens, acessibilidade e paridade entre português e inglês. O desempenho é medido nas páginas principais.
-
Prévia e aprovação.
Cada mudança gera uma prévia. Nada vai ao ar sem eu ver e aprovar.
Fundamentos
Cor
Uma paleta de cinzas em que a cor é sinal, não decoração: verde só para sucesso, vermelho só para erro e ação destrutiva. Troque o tema no rodapé e veja os mesmos tokens mudarem. O contraste de cada texto é medido sobre o fundo da página (o da ação, sobre a própria ação) e calculado dos tokens, com a fórmula da WCAG.
-
--paperFundo da página -
--cardCartões e painéis -
--tintPreenchimento sutil -
--lineBordas e divisores -
--inkTítulos e texto principal claro 17,1:1 · escuro 16,5:1 -
--bodyTexto corrido claro 10,3:1 · escuro 12,1:1 -
--mutedApoio e legendas claro 5,8:1 · escuro 7,3:1 -
--accentAção · texto sobre ela claro 18,8:1 · escuro 16,5:1 -
--okSucesso claro 4,7:1 · escuro 10,7:1 -
--error-strongTexto de erro claro 7,5:1 · escuro 10,9:1
Tipografia
Três famílias, três papéis, nunca misturados no mesmo elemento. A escala tem dez degraus; no celular, os títulos encolhem.
- Design que vira decisão.
- Texto corrido com 1,55 de entrelinha, para ler sem esforço.
- --t-body: 15px
--t-display-xl--t-display-l--t-display-m--t-h2--t-card--t-h3--t-body-l--t-body--t-small--t-micro
Espaço, raio e alvo de toque
Dez degraus de espaço e cinco raios. No celular, toda ação principal tem pelo menos 44 px de alvo; os controles compactos do rodapé ficam em 32.
--s-1--s-2--s-3--s-4--s-5--s-6--s-7--s-8--s-9--s-10
--r-s--r-m--r-l--r-xl--r-pill
Movimento
Uma curva e três tempos, iguais em todo o site.
-
--d-fast150 ms Hover e pressionado -
--d-base250 ms Troca de estado e saídas -
--d-slow400 ms Entrada de painéis
Componentes
Os mesmos componentes das páginas, ao vivo. Todo controle tem repouso, hover, pressionado, foco e, quando cabe, desabilitado: passe o mouse ou navegue com Tab.
Botões
Seletor, filtros e etiquetas
Campos
Regras
Componente só usa token semântico. Cor escrita direto no CSS reprova a verificação.
Três famílias, três papéis, nunca misturados no mesmo elemento.
Texto nunca abaixo de 12 px.
Uma ação primária por bloco. O rodapé é o convite final.
Um anel de foco na cor da ação, com 2 px de anel e 2 px de afastamento. No campo com erro, ele fica vermelho.
Todo controle tem repouso, hover, pressionado, foco e, quando cabe, desabilitado.
No celular, toda ação principal tem pelo menos 44 px de alvo.
Estado nunca depende só de cor.
"Ver" leva a conteúdo do site. "Abrir", sempre com ↗, leva para fora.
Uma curva de movimento e três tempos, iguais em todo o site.
Decisões registradas
Quatro das 44 decisões do registro, para mostrar o tipo de coisa que entra nele: o que mudou, por quê e como foi provado.
Uma cor de foco.
Links e controles usavam cores de foco diferentes, às vezes no mesmo formulário. O anel passou a ter a cor da ação nos dois temas; só o campo com erro o troca por vermelho.
Borda de campo que aparece.
A borda dos campos em repouso tinha 1,3:1 e sumia no cartão. Passou a 3,8:1 no claro e 3,7:1 no escuro, acima dos 3:1 que a WCAG pede para componentes.
Relógio sem segundos.
O relógio do rodapé trocava os segundos ao lado do texto e puxava o olho de quem lia. Passou a mostrar só hora e minuto: uma troca por minuto em vez de uma por segundo, com um teste que falhava antes da mudança.
A própria página achou um defeito.
A etiqueta verde de sucesso tinha 3,97:1 de contraste no tema claro, abaixo dos 4,5:1. Nenhuma página a usava; quando esta documentação a mostrou, o teste de acessibilidade reprovou. A etiqueta ganhou fundo e texto próprios (4,9:1 no claro) e o par entrou no teste de contraste.
Feito com agentes de IA
O site foi implementado por agentes de IA, em fases pequenas, cada uma no seu pacote de mudanças. Comigo ficam a direção de design, as decisões e o ok de cada fase.
Revisão independente.
Nas fases de risco, outro agente revisa o trabalho e tenta derrubar cada achado. Só o que se sustenta vira correção.
Vermelho antes do verde.
Correção de comportamento vem, sempre que dá, com um teste que falhava antes dela. Teste que nunca falhou não prova nada.
Regras que a máquina lê.
Tokens, rotas e limites ficam em arquivos que os agentes leem e os testes conferem. As contagens e os contrastes desta página saem desses arquivos no build.
Ponte com o DS Mistério.
O site declara os nomes do contrato do DS Mistério, meu design system para agentes, ligados aos tokens daqui, para que os componentes de lá rodem neste site com as cores e medidas dele.
Ver o DS MistérioPrincípio não muda comportamento. Checklist muda.