Cores
Todas as cores são CSS Custom Properties (--mds-colors-*), nunca hex fixo no HTML/CSS de consumo. Cada papel semântico tem 5 tons (lighter, light, main, dark, darker) + seu par de contraste — nomenclatura alinhada ao Figma (--mds-colors-<papel>-<tom> para o fundo, --mds-colors-<papel>-on-<tom> para o texto/ícone legível sobre ele, ex.: --mds-colors-primary-main + --mds-colors-primary-on-main).
Escalas e acessibilidade
Seção intitulada “Escalas e acessibilidade”As paletas do sistema com os valores reais dos tokens, nos temas claro, escuro e dark blue. Escolha uma paleta para ver a escala completa (50 a 900) e a matriz de contraste entre fundos e textos, em APCA ou WCAG 2, no tamanho e peso de texto que você vai usar.
Paletas do sistema
Os cinco tons que cada paleta expõe como token, com o texto que o sistema usa sobre eles (on-*): o claro ou o escuro,o que tiver o maior contraste APCA. O número ao lado é o contraste desse par. Clique numa paleta para ver a escala completa e a matriz.
Escala
Matriz de acessibilidade
Cada linha é um fundo e cada coluna, uma cor de texto. As duas primeiras linhas são as superfícies do tema (card e página); as duas primeiras colunas, os textos claro e escuro da paleta. Em cada fundo, ★ marca o texto de maior contraste APCA: é ele que vira o on-* do tom. Clique numa célula para ver o par aplicado.
Prévia do par
Quer testar uma cor que ainda não está no sistema? Use o Gerador de cores. Para entender de onde vêm os valores (a fórmula da escala, como o par on-<tom> é escolhido e o build), veja Geração de Cores.
Tokens de cor
Seção intitulada “Tokens de cor”Papéis semânticos (tema claro)
Seção intitulada “Papéis semânticos (tema claro)”| Papel | Token base | lighter |
light |
main |
dark |
darker |
Quando usar |
|---|---|---|---|---|---|---|---|
| Primary | --mds-colors-primary-* |
#ecf3ff |
#a0c4fd |
#408afa |
#3068bb |
#20457d |
Ação principal, marca, item ativo/selecionado, foco de interação |
| Secondary | --mds-colors-secondary-* |
#e9ebf3 |
#939ac5 |
#27348b |
#1d2768 |
#141a46 |
Marca institucional, badges/destaques secundários, campo válido (borda) |
| Danger | --mds-colors-danger-* |
#fcebe6 |
#f29980 |
#e53200 |
#ac2600 |
#731900 |
Erro, exclusão, bloqueio, ação irreversível |
| Warning | --mds-colors-warning-* |
#fef9e6 |
#f8e280 |
#f0c400 |
#b49300 |
#786200 |
Atenção, campo obrigatório, dado pendente de revisão |
| Info | --mds-colors-info-* |
#e6f3fb |
#80c3ed |
#0087db |
#0065a4 |
#00446e |
Mensagem neutra, dica, estado informativo sem urgência |
| Success | --mds-colors-success-* |
#e6f9e6 |
#80e381 |
#00c703 |
#009502 |
#006402 |
Confirmação, conclusão, dado validado |
on-<tom> é a cor de texto/ícone garantida legível sobre aquele fundo — sempre use o par (--mds-colors-<papel>-main + --mds-colors-<papel>-on-main), nunca aplique texto escuro fixo sobre um fundo de token.
Os fundos de todas as famílias de cor batem com o Figma Design System 2.0. Histórico das conferências e das correções:
docs/historico-cores-e-temas.md(material de manutenção).
Background / Surface / Text (neutros)
Seção intitulada “Background / Surface / Text (neutros)”Escala base: --mds-colors-gray-0 #fefefe … --mds-colors-gray-50 #fafbfc … --mds-colors-gray-100 #f3f4f6 … --mds-colors-gray-200 #e8eaee … --mds-colors-gray-300 #dcdfe5 … --mds-colors-gray-400 #d0d4dc … --mds-colors-gray-500 #9c9fa5 … --mds-colors-gray-600 #686a6e … --mds-colors-gray-700 #343537 … --mds-colors-gray-800 #151516 … --mds-colors-gray-900 #060607.
| Uso | Token | Valor | Regra |
|---|---|---|---|
| Surface / Card | --mds-dimmed-default |
#fefefe |
Fundo padrão de card, modal, painel — “branco” do sistema |
| Background (página) | --mds-colors-background-light |
#fafbfc |
Fundo da aplicação por trás dos cards |
| Background (elemento) | --mds-colors-background-main |
#f3f4f6 |
Fundo de blocos secundários (ex.: .mds-box) |
| Background (rebaixado) | --mds-colors-background-dark |
#e8eaee |
Hover neutro, divisores de área, estado “dimmed” |
| Border | --mds-colors-border-main |
#e8eaee |
Toda borda 1px de card, input, tabela |
| Text — corpo (padrão) | --mds-colors-foreground-main |
#686a6e |
Texto de parágrafo, valor de dado, corpo em geral |
| Text — ênfase/secundário | --mds-colors-foreground-dark |
#343537 |
Título, rótulo em destaque, texto que precisa de mais peso que o corpo |
| Text — muted/apoio | --mds-colors-foreground-light |
#9c9fa5 |
Placeholder, texto de ajuda, timestamp, metadado de baixa prioridade |
Note a inversão de intuição:
foreground-darké o texto de MAIOR ênfase (mais escuro = mais peso), eforeground-lighté o texto de MENOR ênfase (mais claro = apoio). Siga essa semântica, não o nome literal.
Destructive
Seção intitulada “Destructive”Não existe token destructive isolado — Danger cobre esse papel (botão de exclusão = variant="danger" / .mds-btn--danger, --mds-colors-border-error = #e53200).
Overlay / Shadow
Seção intitulada “Overlay / Shadow”--mds-colors-background-shadow:rgba(22, 22, 23, 0.15)— base de toda sombra do sistema.--mds-colors-background-transparency:rgba(52, 53, 55, 0.6)— backdrop de modal/drawer.
Multi-marca ([data-primary="..."])
Seção intitulada “Multi-marca ([data-primary="..."])”| Tenant | Cor main |
|---|---|
brand-mobiis |
#408afa |
blue |
#0087db |
teal |
#00dbdb |
aqua |
#00f0b8 |
green |
#00c703 |
yellow |
#f0c400 |
orange |
#f07800 |
red |
#e53200 |
pink |
#ff0073 |
Tema escuro
Seção intitulada “Tema escuro”[data-theme="dark"] e :root aplicam-se ao mesmo elemento — uma prop não redeclarada em [data-theme="dark"] cai para o valor de :root (cascata normal do CSS); a maioria dos papéis redeclara os 5 tons com valores próprios para dark. Ex.: primary-main é #408afa no claro e #3068bb no escuro. Neutros do tema escuro: fundo #121c2b, texto de corpo #d1d8e2. Um agente de IA nunca deve ler valor de cor fixo: sempre referenciar o token, para funcionar nos dois temas automaticamente.
- Três temas, todos sobre os mesmos tokens: claro (padrão),
[data-theme="dark"]e[data-theme="dark-blue"](neutros azul-marinho). Qualquer tema combina com[data-primary="..."]. - No escuro a sombra quase não aparece: a hierarquia vem da luminosidade da superfície (página
background-light< bloco rebaixadobackground-main< carddimmed-default< hover/borda). Use o token de fundo da camada certa em vez de depender debox-shadowpara separar planos. - Não presuma que
-dark/-darkerescurecem: no tema escuro esses tons clareiam. Não monte hover ou ênfase próprios com esses tons; use os estados que o componente já tem ou os tokens semânticos (foreground-*,border-*,ui-interactive-*). - Contraste já está resolvido nos pares de token (texto de corpo, apoio, erro, link, borda de campo) nos três temas. Texto colorido usa
--mds-colors-foreground-{primary|secondary|error|warning|info|success}, não omaindo papel (note: o de perigo éforeground-error).