Configuration Sources

Configuration sources and runtime activation

Sources

1. src/BlokeBot/appsettings.json contains non-secret defaults and the configuration shape.
2. appsettings.{Environment}.json overlays the base file for the active ASP.NET environment.
3. Environment variables override file values; nested keys use __.
4. Standard ASP.NET command-line configuration remains available when launching the executable directly.

Docker and the NixOS module select Production. The source workflow uses the local ASP.NET environment unless explicitly overridden.

Twitch runtime activation

The dashboard can start without Twitch credentials. The bot runtime remains offline until all four identity values are nonblank:

TwitchBot:Identity:BotUsername
TwitchBot:Identity:ClientId
TwitchBot:Identity:ClientSecret
TwitchBot:Identity:RedirectUri

Once activated, BlokeBot validates identity, runtime timing, and retry policy settings during startup. Invalid active configuration prevents startup rather than silently changing the requested values.

Recommended deployment split

• Put ordinary values in environment variables or an external production settings file.
• Put ClientSecret and any future secrets in a secret manager or protected environment file.
• Keep the token cache and database on durable private storage.