# Modo escuro

> O tema da comunidade (Claro, Escuro ou Automático, que segue o dispositivo), 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 dispositivo de cada pessoa. A escolha vale para a aplicação inteira, incluindo 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 jogos) ou simplesmente para respeitar o que cada pessoa escolheu no telemóvel e no computador.

## Como funciona

### O modo da comunidade

Em **Definições › Marca e aparência**, o cartão **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** (predefinido) | *"Fundo claro, como sempre foi."* |
| **Escuro** | *"Fundo escuro em todas as telas."* |
| **Automático** | *"Segue o tema do dispositivo de cada pessoa."* Se a pessoa muda o tema do dispositivo, a comunidade muda também, sem recarregar |

Não há botão de guardar: o modo fica em vigor assim que clica nele. As [cores](/configuracoes/cores) da comunidade continuam a valer, com os tons ajustados ao fundo escuro.

### Libertado pela Memberfy

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

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

### Logo para fundo escuro

Com o tema libertado, o cartão **Tema** mostra o **Logo para fundo escuro**, usado no lugar do logo quando o ecrã 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** (também aceita JPG e WebP). **Enviar logo** envia, **Trocar logo** substitui e o caixote do lixo (**Remover logo para fundo escuro**) volta ao logo normal na placa. Enviar o logo para fundo escuro não altera 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, descarregar ou abrir noutro sítio, onde o fundo da comunidade não se aplica.

### A escolha de cada pessoa

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

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

A escolha *"Vale só neste navegador e nesta comunidade."*: não vai para o servidor, por isso noutro navegador, noutro dispositivo ou noutra comunidade a pessoa volta a ver o modo da comunidade. Sem a libertação, a secçã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 própria.

## Passo a passo

*Papel: proprietário ou administrador.*

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

*Para si próprio:* **Minha Conta › Aparência** e escolha **Claro**, **Escuro**, **Dispositivo** ou **Seguir a comunidade**.

## Exemplos

**Comunidade de jogos.** 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 telemóvel no tema escuro vê a escola escura; quem usa claro, vê-a clara. Os certificados continuam a sair claros.

## Dicas

- Prefira **Automático** se não tem a certeza: cada pessoa vê como já usa o dispositivo.
- 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 libertado para a comunidade: contacte 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ó nesse navegador: escolha de novo no outro |
| Não encontro **Minha Conta › Aparência** | A secção só aparece quando a comunidade tem o tema escuro libertado |

## Perguntas frequentes

**O e-mail que a comunidade envia 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 a aplicação inteira.

**O modo escolhido desaparece se a libertação for retirada?**
Não. A comunidade aparece clara enquanto estiver sem a libertação, e o modo escolhido volta quando for libertada de novo.

**O assistente (MCP) muda o tema?**
Não. O tema muda-se no ecrã 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 libertado), `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 libertação respondem `422`; enviar o mesmo estado de novo responde `changed: false`. A alteração fica nos [Logs](/membros/registros-de-atividades).
- [`POST /api/upload/community/logo`](/api/referencia/uploads/post-upload-community-logo) com `variant=dark` envia o ficheiro do logo para fundo escuro e devolve só `data.url`, sem trocar o logo normal; depois, grave o 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 pede sempre confirmação. [`get_community_settings`](/mcp/ferramentas-comunidade#get-community-settings) mostra o tema atual e se o escuro está ativado.

## Relacionados

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