# Modo escuro

> O tema da comunidade (Claro, Escuro ou Automático, que segue o aparelho), o logo para fundo escuro, a escolha de cada pessoa em Minha Conta › Aparência e o que continua claro.

A comunidade pode aparecer com fundo claro, com fundo escuro ou seguir o tema do aparelho de cada pessoa. A escolha vale para o app inteiro, inclusive a **Administração**.

## Para que serve

Para quem passa horas na comunidade à noite, para a marca que já é escura (um estúdio de música, uma comunidade de games) ou simplesmente para respeitar o que cada pessoa escolheu no celular e no computador.

## Como funciona

### O modo da comunidade

Em **Configurações › Marca e aparência**, o card **Tema** (*"Como a comunidade aparece para quem não escolheu outro tema. Vale para todo o app, inclusive a Administração."*) tem o campo **Modo**:

| Modo | O que faz |
|---|---|
| **Claro** (padrão) | *"Fundo claro, como sempre foi."* |
| **Escuro** | *"Fundo escuro em todas as telas."* |
| **Automático** | *"Segue o tema do aparelho de cada pessoa."* Se a pessoa troca o tema do aparelho, a comunidade troca junto, sem recarregar |

Não há botão de salvar: o modo vale assim que você clica nele. As [cores](/configuracoes/cores) da comunidade continuam valendo, com os tons ajustados para o fundo escuro.

### Liberado pela Memberfy

O tema escuro é liberado pela Memberfy, comunidade por comunidade. Sem essa liberação, o campo **Modo** mostra só **Claro**, com o aviso *"O tema escuro ainda não foi liberado para esta comunidade. Para usá-lo, fale com o suporte da Memberfy."*

Se a liberação for retirada, a comunidade volta a aparecer clara para todos; o modo que você tinha escolhido fica guardado e volta quando a liberação voltar.

### Logo para fundo escuro

Com o tema liberado, o card **Tema** mostra o **Logo para fundo escuro**, usado no lugar do logo quando a tela está no tema escuro. Sem ele, o logo normal aparece sobre uma placa clara, para continuar legível. O ideal é um **PNG com fundo transparente** (aceita também JPG e WebP). **Enviar logo** envia, **Trocar logo** substitui e a lixeira (**Remover logo para fundo escuro**) volta para o logo normal na placa. Enviar o logo para fundo escuro não muda o logo normal (ver [Imagens e SEO](/configuracoes/imagens-e-seo)).

### O que continua claro

Os **e-mails**, os **certificados** e a **arte de reconhecimento** continuam claros em qualquer modo: são feitos para imprimir, baixar ou abrir em outro lugar, onde o fundo da comunidade não vale.

### A escolha de cada pessoa

Com o tema liberado, cada pessoa tem a seção **Minha Conta › Aparência** (*"O tema que você vê nesta comunidade."*), com o campo **Tema**:

| Opção | O que faz |
|---|---|
| **Seguir a comunidade** (padrão) | O modo que a comunidade escolheu (*"Hoje: claro."*, *"Hoje: automático, pelo aparelho."*) |
| **Claro** | *"Sempre com fundo claro."* |
| **Escuro** | *"Sempre com fundo escuro."* |
| **Aparelho** | *"Claro ou escuro, como o seu aparelho estiver."* |

A escolha *"Vale só neste navegador e nesta comunidade."*: ela não vai para o servidor, então em outro navegador, em outro aparelho ou em outra comunidade a pessoa volta a ver o modo da comunidade. Sem a liberação, a seção **Aparência** não aparece.

### Quem pode

O modo da comunidade e o logo para fundo escuro: **proprietário** e **administrador**. A escolha em **Minha Conta › Aparência**: qualquer pessoa, para si mesma.

## Passo a passo

*Papel: proprietário ou administrador.*

1. **Configurações › Marca e aparência**, card **Tema**.
2. Em **Modo**, clique em **Escuro** ou **Automático**. Se só aparece **Claro**, fale com o suporte da Memberfy para liberar o tema escuro.
3. Em **Logo para fundo escuro**, **Enviar logo** e escolha um PNG com fundo transparente.
4. Abra a comunidade no celular com o tema escuro ligado e confira o topo e os botões.

*Para você mesmo:* **Minha Conta › Aparência** e escolha **Claro**, **Escuro**, **Aparelho** ou **Seguir a comunidade**.

## Exemplos

**Comunidade de games.** Modo **Escuro**, com o logo branco em PNG transparente como **Logo para fundo escuro**. Quem prefere ler com fundo claro escolhe **Claro** em **Minha Conta › Aparência**.

**Escola com público variado.** Modo **Automático**: quem usa o celular no tema escuro vê a escola escura; quem usa claro, vê clara. Os certificados continuam saindo claros.

## Dicas

- Prefira **Automático** se você não tem certeza: cada pessoa vê como já usa o aparelho.
- O logo para fundo escuro costuma ser a versão branca ou clara da marca.
- Depois de ligar, confira as cores da comunidade no escuro: um tom muito escuro na cor primária pode perder contraste com o fundo.

## Erros comuns e como resolver

| Situação | O que fazer |
|---|---|
| Só aparece **Claro** em **Modo** | O tema escuro ainda não foi liberado para a comunidade: fale com o suporte da Memberfy |
| O logo aparece numa placa clara no tema escuro | Envie o **Logo para fundo escuro** |
| Escolhi **Escuro** em **Minha Conta › Aparência** e no outro computador está claro | A escolha vale só naquele navegador: escolha de novo no outro |
| Não encontro **Minha Conta › Aparência** | A seção só aparece quando a comunidade tem o tema escuro liberado |

## Perguntas frequentes

**O e-mail que a comunidade manda fica escuro?**
Não. E-mails, certificados e a arte de reconhecimento continuam claros.

**A Administração também fica escura?**
Sim. O modo vale para o app inteiro.

**O modo escolhido some se a liberação for retirada?**
Não. A comunidade aparece clara enquanto estiver sem a liberação, e o modo escolhido volta quando ela for liberada de novo.

**O assistente (MCP) muda o tema?**
Não. O tema se muda na tela ou pela API.

## Na API

- As leituras da comunidade trazem `appearance`: `mode` (`light`, `dark` ou `auto`, o que a comunidade escolheu), `effectiveMode` (o que vale agora: `light` enquanto o tema não estiver liberado), `darkLogoUrl` e `darkModeAllowed`. Uma comunidade que nunca mexeu lê `light`, sem logo para fundo escuro.
- [`PATCH /api/communities/appearance`](/api/referencia/communities/update-community-appearance) (proprietário e administrador): `mode` e `darkLogoUrl` (`null` remove). `dark` ou `auto` sem a liberação respondem `422`; mandar o mesmo estado de novo responde `changed: false`. A mudança fica nos [Logs](/membros/registros-de-atividades).
- [`POST /api/upload/community/logo`](/api/referencia/uploads/post-upload-community-logo) com `variant=dark` envia o arquivo do logo para fundo escuro e devolve só `data.url`, sem trocar o logo normal; depois, grave a URL com o `PATCH` acima.

## Pelo assistente (MCP)

Peça ao assistente para mudar o tema ou o logo para fundo escuro (*"deixe a comunidade no tema automático"*), com [`update_community_appearance`](/mcp/ferramentas-comunidade#update-community-appearance), para o proprietário e o administrador; ele sempre pede confirmação. [`get_community_settings`](/mcp/ferramentas-comunidade#get-community-settings) mostra o tema atual e se o escuro está liberado.

## Relacionados

- [Cores](/configuracoes/cores)
- [Imagens e SEO](/configuracoes/imagens-e-seo)
- [Conta e perfil](/conceitos/conta-e-perfil)