Design system

Um sistema converte direção em decisões reutilizáveis. Se ele não reduz o número de escolhas que a próxima pessoa precisa fazer, não é sistema — é uma paleta com nomes.

Extraia antes de inventar

Em código existente, o sistema já está lá: implícito, inconsistente e espalhado. O trabalho não é impor uma escala nova sobre tudo — é encontrar o padrão dominante, nomeá-lo e alinhar os desvios.

1. Inventarie os valores reais em uso: cores, tamanhos de fonte, espaçamentos, raios.
2. Conte a frequência. O valor mais usado costuma ser o certo.
3. Agrupe os quase-iguais (14px, 15px, 0.9rem são o mesmo degrau tentando existir).
4. Nomeie por papel e migre os desvios.

Um sistema que ignora o incumbente vira segunda fonte da verdade — e duas fontes da verdade é pior que nenhuma.

Cor por papel

Nunca uma lista de hexes. Papéis, para que tema seja troca de valores e não reescrita.