# Configuração

Configurações de runtime, idiomas do site, temas e assets do navegador.

## Ambiente de runtime

Guarde as credenciais no `.env`, fora do conteúdo versionado da aplicação. O repositório do framework inclui um `.env.example`; use-o como referência atual das configurações, em vez de copiar segredos entre projetos.

| Configuração | Finalidade |
|---|---|
| `APP_ENV` | Nome do ambiente |
| `PEPPER` | Segredo estável usado pela autenticação e por dados criptografados |
| `SITE_URL` | URL pública para jobs que geram links absolutos |
| `BASE_PATH` | Prefixo opcional para uma instalação num alias ou subpasta |
| `TRUSTED_PROXIES` | Endereços de proxy confiáveis definidos explicitamente, quando o site está atrás de um proxy |
| `SUBDOMAIN_HOST` | Para um site servido numa subpasta: o host sob o qual ficam os subdomínios, para que os links de subdomínio levem até lá |
| `JOB_RUN_DELAY_MS` | Intervalo entre jobs em segundo plano processados |
| `MAIL_SERVICE`, `MAIL_FROM`, `MAIL_FROM_NAME` | Configuração do envio de e-mail e identidade do remetente do projeto |

Use `env()` em PHP para as configurações de runtime. O `[#env#]` exclui segredos que os templates não devem exibir. Veja [e-mail](/pt/docs/guides/email/) para as configurações de cada serviço de e-mail.

## Configurações do site

O registro `.config/site` descreve o nome e a descrição do site, os idiomas, a direção do texto e a posição da barra lateral do admin. A página de configurações do admin edita esses valores para usuários autorizados. Os metadados das páginas são separados das configurações do site.

## Tema e assets

As escolhas de tema da aplicação ficam em `ext/tailwind.theme.js` e `ext/theme.css`. O Tailwind CSS lê as classes dos templates durante o build: use nomes de classe completos e encontráveis. Rode `./nimbly build` depois de mudar as entradas do build. Veja [Build](/pt/docs/operate/build/).