# Configuratie

Runtime-instellingen, sitetalen, thema's en browser-assets.

## Runtime-omgeving

Bewaar inloggegevens in `.env`, buiten de gevolgde content van de applicatie. De repository van het framework bevat `.env.example`; gebruik die als actueel overzicht van de instellingen, in plaats van geheimen tussen projecten te kopiëren.

| Instelling | Doel |
|---|---|
| `APP_ENV` | Naam van de omgeving |
| `PEPPER` | Vast geheim voor authenticatie en versleutelde data |
| `SITE_URL` | Publieke URL voor jobs die absolute links maken |
| `BASE_PATH` | Optioneel voorvoegsel voor een installatie onder een alias of in een submap |
| `TRUSTED_PROXIES` | Uitdrukkelijk vertrouwde proxyadressen, als de site achter een proxy staat |
| `SUBDOMAIN_HOST` | Voor een site in een submap: de host waaronder de subdomeinen staan, zodat links naar subdomeinen daarheen leiden |
| `JOB_RUN_DELAY_MS` | Wachttijd tussen verwerkte achtergrondjobs |
| `MAIL_SERVICE`, `MAIL_FROM`, `MAIL_FROM_NAME` | Instellingen voor mailverzending en de afzender van het project |

Gebruik in PHP `env()` voor runtime-instellingen. `[#env#]` laat geheimen weg die templates niet mogen tonen. Zie [e-mail](/nl/docs/guides/email/) voor instellingen per maildienst.

## Site-instellingen

Het record `.config/site` beschrijft de naam en beschrijving van de site, de talen, de tekstrichting en de plek van de zijbalk in de admin. De instellingenpagina van de admin bewerkt deze waarden voor bevoegde gebruikers. Metadata van pagina's staan los van de site-instellingen.

## Thema en assets

De themakeuzes van de applicatie staan in `ext/tailwind.theme.js` en `ext/theme.css`. Tailwind CSS leest de classes in templates tijdens de build: gebruik volledige classnamen die te vinden zijn. Draai `./nimbly build` nadat je build-invoer hebt aangepast. Zie [Build](/nl/docs/operate/build/).