Sistema de cores do Veritas em todo front-end (Vite, Next.js, React Native e templates Django), pela regra 60-30-10. Use ao escolher ou mudar uma paleta, criar tokens de cor ou tema, montar modo escuro, definir cor de botão, link, foco, erro ou sucesso, ou quando um texto parecer apagado, a tela parecer colorida demais ou alguém pedir contraste e acessibilidade de cor.
El texto de las convenciones está escrito en portugués y se muestra aquí tal como está en el repositorio.
Cores — 60-30-10 e contraste medido
Projeto que já existe? Estas convenções valem para código novo e para remodelação. Em sistema legado, de cliente ou de outra equipe, a arquitetura do projeto manda: antes da primeira mudança, siga
veritas:projeto-existente.Dado pessoal? Código que toca CPF, contato, saúde, dado financeiro ou credencial, e todo log, exportação ou integração, segue também a
veritas:lgpd, em qualquer modo.
Cor é orçamento: cada área da tela gasta uma fatia, e quem gasta mais que a sua fatia some com a hierarquia. A casa divide assim:
| Fatia | Papel | Onde aparece |
|---|---|---|
| 60% | dominante | fundo da página, grandes áreas vazias |
| 30% | secundária | superfícies: card, seção alternada, barra de navegação, painel lateral, campo |
| 10% | destaque | a ação principal, link, anel de foco, o número que importa |
A conta é de área visível, a olho, numa captura da tela inteira. Não precisa medir pixel: precisa o destaque ser raro o bastante para apontar a ação.
Derivar a paleta
- Uma família de matiz para o 60 e o 30. Fundo e superfície são o mesmo matiz com luminosidade diferente. Duas famílias no 60/30 dividem a tela em duas marcas.
- Neutros puxados para a marca. Cinza e quase-preto levam um pouco do
matiz da marca (saturação baixa, 5–15%).
#000,#fffpuro e cinza neutro de framework ficam fora: deixam a tela sem identidade e brigam com a foto. - Destaque que contrasta com o 60/30. Matiz oposto ou bem afastado no
círculo cromático, mais saturado que os neutros. Um destaque. Segundo
destaque é decisão de marca, registrada no
CLAUDE.mddo projeto, não improviso de tela. - Meça antes de usar (seção "Contraste"). Cor bonita que reprova vira outra cor, não exceção.
Paleta que o cliente já tem (manual de marca) entra nos papéis acima: o trabalho é mapear, não reinventar.
Tokens semânticos — definidos uma vez
O componente pede papel, nunca valor. A lista mínima:
| Token | Papel |
|---|---|
bg |
fundo da página (60) |
surface |
card, seção, nav, campo (30) |
text |
texto principal |
muted |
texto secundário, legenda, placeholder |
border |
borda de campo e divisória que identifica controle |
accent |
ação principal, link, foco (10) |
accent-contrast |
texto e ícone sobre o accent |
success, warning, danger |
estado |
Moram num lugar só, na base do front: é a camada abaixo dos atoms
(veritas:atomic-design).
| Stack | Onde |
|---|---|
| Vite, Next.js (Tailwind v4) | @theme no CSS global; as classes saem dos nomes (bg-surface, text-muted) |
| CSS sem Tailwind | custom properties em :root |
| React Native / Expo | um objeto theme em src/theme/, lido por hook; NativeWind usa os mesmos nomes no tailwind.config |
| Django templates | custom properties no base.html (ou no CSS que ele carrega); Tailwind, se o projeto usar, pelo @theme |
Código pronto de cada stack e a paleta de exemplo medida: tokens.md.
Proibido: hex, rgb(), hsl() ou classe de cor crua do framework
(bg-blue-600, text-gray-500) dentro de componente. Cor nova entra primeiro
como token, com papel e contraste medido; depois o componente usa o token.
Claro e escuro
O tema escuro é outra paleta, não a clara invertida.
- O 60 vira um quase-preto puxado para o matiz da marca; o 30 fica mais claro que o 60 (no escuro, elevação é luz, não sombra).
- Saturação desce: o destaque que funciona sobre claro vibra demais sobre escuro. Use uma versão mais clara e menos saturada do mesmo matiz.
- Rebalanceie o 60-30-10: superfície grande e clara no escuro pesa mais do que pesava no claro. Confira a captura, não a planilha.
- Sombra quase não aparece no escuro: a separação vem da diferença entre
bgesurface, e daborder. - Os dois temas usam os mesmos nomes de token. Troca o valor, o componente
não muda. Web:
prefers-color-schememais um atributo (data-theme) para a escolha manual. RN:useColorScheme()escolhe o objeto. - Meça o contraste dos dois temas, par por par. Passar no claro não diz nada do escuro.
Cores de estado
success, warning e danger ficam fora do orçamento de 10%, mas
aparecem só onde há estado: mensagem de erro, badge de situação, validação.
Tela inteira vermelha, ou estado usado como decoração, é ruído que ensina o
usuário a ignorar o alerta de verdade.
Cada estado tem variante para o claro e para o escuro, medida como texto (o estado quase sempre é texto ou ícone com texto).
Contraste (WCAG 2.2, nível AA)
| O quê | Mínimo | Fonte |
|---|---|---|
| Texto normal | 4.5:1 | 1.4.3 Contrast (Minimum) |
| Texto grande: ≥ 24px, ou ≥ 18.5px em negrito | 3:1 | idem (18pt / 14pt bold) |
| Borda de campo, ícone que é controle, estado de componente, indicador de foco | 3:1 contra o que está ao lado | 1.4.11 Non-text Contrast |
- O limite não arredonda: 4.49:1 reprova em 4.5.
- Vale para placeholder, texto em hover e texto sobre foto (meça contra a área mais clara da foto, ou ponha um véu sólido atrás).
- Controle desabilitado não tem mínimo, mas precisa parecer desabilitado por
outro sinal além da cor (cursor, opacidade com rótulo, atributo
disabled). - Cor de marca não é exceção: só logotipo é.
Nunca só a cor. Erro tem ícone ou texto além do vermelho; link no meio do texto tem sublinhado; gráfico tem rótulo ou padrão além da legenda colorida (1.4.1 Use of Color).
Como medir
Razão = (L1 + 0.05) / (L2 + 0.05), com L1 a luminância relativa da cor mais
clara e L2 a da mais escura. A luminância vem do sRGB linearizado:
L = 0.2126 R + 0.7152 G + 0.0722 B, cada canal c/255 passado por
c ≤ 0.04045 ? c/12.92 : ((c+0.055)/1.055)^2.4.
Não estime de olho. Rode o script ao lado (Node, sem dependência):
node contraste.mjs "#16212B" "#F4F6F8" "#FFFFFF" "#A63D0E"
# #16212B sobre #F4F6F8: 15.07:1 | texto passa | texto grande e UI passa
Qualquer ferramenta que use a mesma fórmula serve (DevTools do navegador, Accessibility Inspector, Accessibility Scanner). O que conta é o número escrito na entrega, par por par, nos dois temas.
Antes de entregar
- Toda cor de componente vem de token; zero hex no componente.
- Captura da tela: destaque raro, superfície e fundo do mesmo matiz.
- Pares
text,mutedeaccentsobrebgesurface, eaccent-contrastsobreaccent, medidos nos dois temas. -
borderde campo e anel de foco ≥ 3:1 contra o vizinho. - Nenhuma informação só por cor.
Tipo, espaço e raio: veritas:tipografia-e-espacamento. Uso da cor numa
página pública (gradiente, brilho, foto): veritas:direcao-de-arte. Conferir
na tela renderizada: veritas:revisao-de-design.
Origem
Banco de skills do Veritas, skill cores. Criada em 2026-11-12. Os mínimos de
contraste e a fórmula vêm das páginas Understanding do WCAG 2.2 (W3C),
conferidas na data. A divisão 60-30-10 é regra clássica de design de
interiores aplicada a tela; os nomes de token e as proibições são escolha da
casa. Inspiração: ver "Inspiração" no README do plugin.
Correções vão por PR no repositório, não editando a cópia local.