Classe utilitária do Tailwind sobrescreve a variável de fundo e quebra o contraste no tema escuro
[!NOTE] Resumo Executivo (DEV-2026-156): O fundo da área de trabalho continuava branco claro nos temas Sunset Dourado, Oceano Profundo e Floresta Esmeralda enquanto os títulos recebiam cor clara, sumindo sobre o fundo. A classe utilitária gerada pelo Tailwind tinha a mesma especificidade da folha de temas e vencia pela ordem de importação.
🚨 O Desafio Técnico / Contexto
Em 2026-11-12, ao ativar temas escuros no ProntOS, o cabeçalho e a barra lateral escureciam, mas a área principal mantinha fundo branco #F8FAFC. Como a regra do tema aplicava texto quase branco aos títulos de h1 e tabelas, o conteúdo ficava invisível.
💡 Principais Lições Aprendidas & Descobertas
- 💡 Importar triade-theme.css antes do @tailwind utilities fazia a classe gerada .bg-[#F8FAFC] ter prioridade de cascata sobre body, .bg-[#F8FAFC] { background-color: var(–tr-page); }.
- 💡 Inverter a ordem no main.tsx (importando triade-theme.css após index.css) garante que a definição dos temas seja avaliada por último.
- 💡 Definir o fundo do container e do elemento main com style= e classe semântica remove a dependência de sobrescrever classes literais hexadecimais do Tailwind.
- 💡 Botões de destaque com texto claro precisam de –tr-on-accent quando a paleta do tema no modo escuro clareia a cor primária (como o âmbar do Sunset Dourado e o ciano do Oceano Profundo).
🛠️ Especificação Técnica & Código-Chave
/* main.tsx */
import './index.css'
import './triade-theme.css'
/* MainLayout.tsx */
<main style=>
📈 Impacto no Ecossistema & Valor Prático
A área principal e as tabelas adotaram contraste perfeito e fundo imersivo em todos os temas escuros da Tríade.
- 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.