Cookie compartilhado no domínio pai sincroniza tema e modo escuro entre subdomínios da Tríade

[!NOTE] Resumo Executivo (DEV-2026-155): O ProntOS e o Agenda rodam em repositórios e containers separados, mas passaram a compartilhar a mesma identidade visual e escolha de tema do usuário. O cookie triade_theme no domínio pai .artesdosul.com sincroniza seis paletas e o modo claro ou escuro entre subdomínios.


🚨 O Desafio Técnico / Contexto

Em 2026-11-12, o ProntOS precisava incorporar o Design System e o seletor de temas do agenda.artesdosul.com mantendo a preferência visual do usuário ao navegar entre os aplicativos do ecossistema.


💡 Principais Lições Aprendidas & Descobertas

  • 💡 Em frontend/src/lib/triadeTheme.ts, gravar o cookie triade_theme=: com Domain=.artesdosul.com; Path=/; SameSite=Lax permite que qualquer subdomínio leia a paleta escolhida na primeira renderização.
  • 💡 Aplicar data-triade-theme e data-triade-mode no document.documentElement junto com variáveis CSS (–tr-blue-50..950, –tr-gray-50..950 e –tr-sgray-50..950) mapeadas no tailwind.config.js troca toda a paleta e o modo escuro sem recarregar a página.
  • 💡 A sincronização em dois sentidos (cookie compartilhado para outros subdomínios e localStorage para ambiente local em localhost) garante o mesmo funcionamento em desenvolvimento e em produção.

🛠️ Especificação Técnica & Código-Chave

document.cookie = `triade_theme=${encodeURIComponent(`${theme}:${mode}`)}; Max-Age=31536000; Path=/; SameSite=Lax; Domain=.artesdosul.com; Secure`;
document.documentElement.setAttribute('data-triade-theme', theme);
document.documentElement.setAttribute('data-triade-mode', mode);

📈 Impacto no Ecossistema & Valor Prático

Trocar o tema ou o modo escuro no ProntOS reflete automaticamente no Agenda e nos demais sistemas da Tríade sob o mesmo domínio.

  • Projetos Relacionados: 30-FieldFlow, triade-artesdosul
  • Registro de Origem: _data/daily.dev-27.yml

Publicado originalmente como parte do Diário de Desenvolvimento 2026 do ecossistema Artes do Sul & Araguaci.