Design System Artes do Sul
Fonte única de verdade: design-system.json (v3.0.0). A paleta vem de
themes/ e está replicada em sourcePalette no JSON:
| Claro | Escuro | |
|---|---|---|
| Primária | #691345 (roxo) |
#FF7F50 (coral) |
| Destaque | #FF7F50 (coral) |
#38bdf8 |
| Canvas | #FBF6F3 |
#0a1118 |
| Texto | #1A1016 |
#F8F4F2 |
| Borda | #E7D8D2 |
#334155 |
Arquivos de origem:
themes/home-assistant/artes-do-sul.yaml— modos light/darkthemes/editors/artes-do-sul-light-color-theme.jsonthemes/editors/artes-do-sul-dark-color-theme.json
Artefatos
| Arquivo | Papel | Editar à mão? |
|---|---|---|
design-system.json |
tokens, sourcePalette, cognitiveLaws, foundations, contratos |
sim |
design-system.css |
tokens CSS, ponte Bootstrap 5, ponte Tailwind, base acessível, utilitários | não — gerado |
design-system.js |
runtime: sincroniza data-ds-theme/data-bs-theme e meta theme-color |
sim |
scripts/build-design-system.mjs |
gera o CSS a partir do JSON | sim |
scripts/apply-design-system.mjs |
recoloriza e injeta o DS nas 120 páginas HTML da raiz | sim |
scripts/verify-design-system.mjs |
audita injeção, cores legadas e seletores | sim |
Comandos
node scripts/build-design-system.mjs # regenera design-system.css
node scripts/apply-design-system.mjs --dry # relatório, sem gravar
node scripts/apply-design-system.mjs # aplica (cria backup em %TEMP%)
node scripts/verify-design-system.mjs # auditoria
Ordem recomendada após mudar o JSON: build → apply → verify.
O apply é idempotente: cada página recebe data-ds-applied="<versão>-2".
Se o marcador já existe, a recolorização é ignorada. Para mudar a lógica de
recolorização, restaure as páginas a partir de um backup e rode novamente:
Copy-Item "$env:TEMP\tpl-designsystem-backup-YYYY-MM-DD...\*.html" . -Force
O backup das páginas originais está em
%TEMP%\tpl-designsystem-backup-2026-11-14T18-16-31-389Z (120 arquivos).
O que o apply faz
- Classifica a página como clara ou escura (
data-bs-theme, classes do<body>, variáveis CSS, cor de fundo; fallback claro).DS_DEBUG=1mostra o motivo. - Substitui cores literais em
<style>,style="..."e em strings de cor dentro de<script>(configs Tailwind, gráficos, gradientes). Cores são valores concretos, nãovar(), para não quebrar canvas/JS. - Mapeia por papel da propriedade (
background,color,borderou nomes de variáveis como--bg/--text), para que neutros de borda e de texto não virem a mesma cor. - Injeta
design-system.css,design-system.js,data-ds-themeemeta theme-color.
Preservado de propósito
- Marcas de terceiros: Bitcoin, Ethereum, WhatsApp, Telegram, Pix, Twitter, Facebook, LinkedIn, bandeira do Brasil, loterias, efeito Matrix e branco puro.
- Páginas cuja paleta é o próprio conteúdo:
pantone.html,conversor-cores.html,design-de-sistemas-cia.html,design-de-sistemas.html(recebem os tokens, mas não são recolorizadas). - Comparações de cor em JS (
if (x === '#fff')) nunca são alteradas.
Pontes de framework
- Bootstrap 5:
--bs-*e--bs-*-rgbapontam para os tokens, então.bg-primary,.bg-success,.badge.bg-secondary,.btn-primary, etc. usam a paleta da marca. - Tailwind:
design-system.csscontém overrides!importantapenas para as classes de cor efetivamente usadas nas páginas (levantadas no build). Assimtext-blue-600,bg-gray-100,from-emerald-500etc. ficam na paleta mesmo com o CDN injetando CSS depois do nosso<link>.
Runtime
window.DesignSystem.setTheme('light'|'dark') alterna o tema e persiste a
preferência. Páginas com modo explícito (data-ds-theme) não são alteradas
automaticamente por prefers-color-scheme, pois foram recolorizadas
estaticamente — apenas mudanças pedidas pela própria página são acompanhadas.