# Fluig Dark Mode

> Adapta CSS de customizações Fluig ao modo escuro (dark mode) substituindo cores fixas por variáveis CSS de tema no formato var(--fs-color-*), garantindo que o componente acompanhe a troca de tema automaticamente sem código adicional. Use quando o desenvolvedor pedir para dar suporte a dark mode, adaptar estilos ao tema ativo ou remover hexadecimais fixos de cores de um trecho/arquivo CSS.

- Skill: `totvs/fluig-dark-mode` (Agent Skill)
- Install (CLI): `npx skillmds@latest add totvs/fluig-dark-mode`
- Raw SKILL.md: https://api.skillmd.com/api/skills/totvs/fluig-dark-mode/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: totvs (https://skillmd.com/u/totvs)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/totvs/fluig-dark-mode

---


# Adaptação ao Modo Escuro (Dark Mode)

Esta skill adapta o CSS de customizações Fluig ao dark mode usando variáveis de tema; ela **não duplica** os tokens de cor nem a **tabela de mapeamento de cores** (uso comum → `var(--fs-color-*)` e hexadecimal → `var(--fs-color-*)`) — o arquivo de `context/` é a fonte de verdade, referenciada abaixo.

## Objetivo

Adaptar, com responsabilidade única, o **CSS de uma customização ao modo escuro**, substituindo cores fixas (hexadecimais, `rgb()`, nomes de cor) por **variáveis CSS de tema no formato `var(--fs-color-*)`**, para que o componente acompanhe a troca de tema (claro/escuro) automaticamente, sem alterar o comportamento nem o layout.

## Quando Usar

- Quando um widget/Custom Element usa **hexadecimais fixos** (`#fff`, `#202020`) para cores de tema.
- Quando o componente **não acompanha** a troca de tema e fica ilegível no modo escuro.
- Antes de publicar uma customização que precisa **dar suporte a dark mode**.
- Ao revisar CSS próprio e detectar cores que deveriam vir do tema (texto, fundo, borda, sombra).

## Entradas Esperadas

| Entrada | Descrição | Obrigatória |
|---------|-----------|-------------|
| Código/CSS alvo | Trecho ou arquivo CSS com cores a adaptar ao tema | sim |
| Contexto do componente | Tipo/função do elemento (cabeçalho, card, botão, texto) para escolher a família de token adequada | não |
| Tokens já em uso | Variáveis `var(--fs-color-*)` já adotadas no componente, a manter consistentes | não |

## Contexto de Referência (Fonte de Verdade)

Leia antes de executar — não reproduza o conteúdo aqui:

- [style-guide.md](../../context/style-guide.md) — seção **Theming e dark mode (variáveis CSS)**: regra obrigatória de usar `var(--fs-color-*)`, proibição de hexadecimais fixos e de variáveis SCSS para cores de tema, tabelas completas de todas as famílias de tokens (marca, ação, neutros, feedback com tons `lightest`→`darkest`, sombras `--fs-shadow-*`) e a **tabela de mapeamento de cores** (uso comum → `var(--fs-color-*)` e hexadecimal → `var(--fs-color-*)`) usada para converter cores fixas.
- Referência completa das **variáveis CSS**: `references/helpers-and-variables-css/css-variables.md`.

## Regras Aplicáveis (Resumo Executivo)

Somente o mínimo para orientar a tarefa; o detalhe e o catálogo de tokens estão no contexto:

- Para **qualquer cor de tema**, usar variáveis CSS no formato `var(--fs-color-*)` → ver `style-guide.md`.
- ⚠️ **Proibido inventar variáveis CSS.** Usar **somente** as variáveis documentadas em `references/helpers-and-variables-css/css-variables.md`. Se uma variável não estiver nessa referência, ela não existe no Style Guide — nesse caso, use um valor CSS convencional ou CSS próprio escopado.
- **Hexadecimais fixos e variáveis SCSS (`$...`) para cores de tema são proibidos** — não acompanham a troca de tema e quebram o dark mode → ver `style-guide.md`.
- Ao converter cores fixas, consultar a **tabela de mapeamento de cores** (uso comum → variável e hexadecimal → variável) que vive em `style-guide.md` → ver `style-guide.md`.
- Escolher a **família de token** conforme o papel da cor: marca (`--fs-color-brand-*`), ação (`--fs-color-action-*`), neutros (`--fs-color-neutral-*`), feedback (`--fs-color-positive/negative/warning/info-*`) → ver `style-guide.md`.
- Usar tokens de **sombra** (`--fs-shadow-*`) e **tipografia** (`--fs-font-*`) em vez de valores fixos, quando aplicável → ver `style-guide.md`.
- **Reutilizar componentes/classes do Style Guide** já adaptados ao tema, em vez de recriar estilos → ver `style-guide.md`.
- **Preservar** o layout e o comportamento: trocar apenas a origem da cor, não a estrutura.

## Procedimento

1. Ler o CSS alvo e listar todas as cores fixas usadas (hexadecimais, `rgb()`, nomes de cor) e sombras com valores fixos.
2. Classificar cada cor pelo seu papel (texto, fundo, borda, ação, feedback) para escolher a família de token correta.
3. Substituir cada cor fixa pela variável `var(--fs-color-*)` correspondente, consultando a **tabela de mapeamento de cores** (uso comum → variável e hexadecimal → variável) em `style-guide.md`.
4. Trocar sombras fixas por tokens `--fs-shadow-*` e, quando houver, fonte/cor de texto por tokens `--fs-font-*`.
5. Verificar que **nenhum hexadecimal fixo de cor de tema** permaneceu e que o layout não mudou.
6. Conferir o resultado com o checklist abaixo antes de entregar.

## Saída Esperada

CSS adaptado ao dark mode, com todas as cores de tema expressas como `var(--fs-color-*)` (e sombras/tipografia via tokens quando aplicável), sem hexadecimais fixos de tema, com layout e comportamento preservados e adaptação automática à troca de tema. Em conformidade com `context/style-guide.md`.

## Exemplo de Uso

Antes (cores fixas — não acompanham o tema, quebram no dark mode):

```css
/* ❌ hexadecimal fixo: ilegível ao trocar para o modo escuro */
.my-widget__header {
  color: #202020;
  background-color: #ffffff;
  box-shadow: 0 1px 2px rgba(0, 0, 0, 0.15);
}
```

Depois (variáveis de tema — adaptam-se automaticamente):

```css
/* ✅ usa var(--fs-color-*) e token de sombra: adapta a dark mode sem código extra */
.my-widget__header {
  color: var(--fs-color-neutral-dark-90);
  background-color: var(--fs-color-neutral-light-00);
  box-shadow: var(--fs-shadow-sm);
}
```

## Checklist de Validação

- [ ] Toda cor de tema usa `var(--fs-color-*)`; nenhum hexadecimal fixo de tema permaneceu.
- [ ] A família de token escolhida corresponde ao papel da cor (marca/ação/neutros/feedback).
- [ ] Sombras usam `--fs-shadow-*` e tipografia usa `--fs-font-*` quando aplicável.
- [ ] Layout e comportamento preservados (somente a origem da cor mudou).
- [ ] Tokens consistentes com os já adotados no componente e com `style-guide.md`.