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/dark
  • themes/editors/artes-do-sul-light-color-theme.json
  • themes/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

  1. Classifica a página como clara ou escura (data-bs-theme, classes do <body>, variáveis CSS, cor de fundo; fallback claro). DS_DEBUG=1 mostra o motivo.
  2. 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ão var(), para não quebrar canvas/JS.
  3. Mapeia por papel da propriedade (background, color, border ou nomes de variáveis como --bg/--text), para que neutros de borda e de texto não virem a mesma cor.
  4. Injeta design-system.css, design-system.js, data-ds-theme e meta 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-*-rgb apontam para os tokens, então .bg-primary, .bg-success, .badge.bg-secondary, .btn-primary, etc. usam a paleta da marca.
  • Tailwind: design-system.css contém overrides !important apenas para as classes de cor efetivamente usadas nas páginas (levantadas no build). Assim text-blue-600, bg-gray-100, from-emerald-500 etc. 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.