/pt/design-system

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.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  • --paper Fundo da página
  • --card Cartões e painéis
  • --tint Preenchimento sutil
  • --line Bordas e divisores
  • --ink Títulos e texto principal claro 17,1:1 · escuro 16,5:1
  • --body Texto corrido claro 10,3:1 · escuro 12,1:1
  • --muted Apoio e legendas claro 5,8:1 · escuro 7,3:1
  • --accent Ação · texto sobre ela claro 18,8:1 · escuro 16,5:1
  • --ok Sucesso claro 4,7:1 · escuro 10,7:1
  • --error-strong Texto 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.

  • Títulos · Inter Tight Design que vira decisão.
  • Leitura · Inter Texto corrido com 1,55 de entrelinha, para ler sem esforço.
  • Código e metadados · IBM Plex Mono --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-fast 150 ms Hover e pressionado
  • --d-base 250 ms Troca de estado e saídas
  • --d-slow 400 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

Etiqueta Publicado Ao vivo

Campos

Dica curta abaixo do campo, quando ajuda.
Falta o domínio, como em nome@empresa.com.

Regras

  1. Componente só usa token semântico. Cor escrita direto no CSS reprova a verificação.

  2. Três famílias, três papéis, nunca misturados no mesmo elemento.

  3. Texto nunca abaixo de 12 px.

  4. Uma ação primária por bloco. O rodapé é o convite final.

  5. 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.

  6. Todo controle tem repouso, hover, pressionado, foco e, quando cabe, desabilitado.

  7. No celular, toda ação principal tem pelo menos 44 px de alvo.

  8. Estado nunca depende só de cor.

  9. "Ver" leva a conteúdo do site. "Abrir", sempre com ↗, leva para fora.

  10. 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.

Princípio não muda comportamento. Checklist muda.

Ver o DS Mistério