Formatting and cleanup

.env.example

@@ -1,40 +1,67 @@
+# -----------------------------------------------------------
+# Logging
+# -----------------------------------------------------------
+# Rust log filter directive (e.g. warn,siren=info)
 RUST_LOG=warn,siren=info
 
+# -----------------------------------------------------------
+# Discord
+# -----------------------------------------------------------
+# Bot token from the Discord Developer Portal → Bot tab → Reset Token
 DISCORD_BOT_TOKEN=
+# OAuth2 client secret from the Discord Developer Portal → OAuth2 tab
 DISCORD_CLIENT_SECRET=
 
+# -----------------------------------------------------------
+# Security
+# -----------------------------------------------------------
+# Secret used to sign JWT tokens — change this before deploying
 JWT_SECRET=changeme
 
+# -----------------------------------------------------------
+# Database
+# -----------------------------------------------------------
 POSTGRES_USER=siren
 POSTGRES_PASSWORD=changeme
 POSTGRES_DB=siren_db
+# Use "siren-postgres" when running inside Docker Compose
 POSTGRES_HOST=localhost
 POSTGRES_PORT=5432
 
-API_BASE_URL=http://localhost:3000
-API_PORT=3000
-API_SESSION_TTL=86400
-
-# Set to a specific origin (e.g. https://yourapp.com) when deploying to
-# production with a separate frontend origin.  Use "*" (the default) in
-# development with the Vite proxy, where CORS is not an issue.
-CORS_ORIGIN=*
-
-UI_PORT=8080
-
+# -----------------------------------------------------------
+# Cache (Valkey)
+# -----------------------------------------------------------
+# Use "siren-valkey" when running inside Docker Compose
 VALKEY_HOST=localhost
 VALKEY_PORT=6379
 
-MINIO_ROOT_USER=siren
-MINIO_ROOT_PASSWORD=changeme
-MINIO_HOST=localhost
-MINIO_PORT=9000
-MINIO_PORT_INTERNAL=9001
+# -----------------------------------------------------------
+# API
+# -----------------------------------------------------------
+# Base URL of the REST API (used to build OAuth2 redirect URIs, etc.)
+API_BASE_URL=http://localhost:3000
+API_PORT=3000
+# OAuth2 session TTL in seconds
+API_SESSION_TTL=86400
 
-# Siren Data integration (Optional)
+# -----------------------------------------------------------
+# UI
+# -----------------------------------------------------------
+# Set to a specific origin (e.g. https://yourapp.com) when deploying to
+# production with a separate frontend origin. Use "*" (the default) in
+# development with the Vite proxy, where CORS is not an issue.
+CORS_ORIGIN=*
+# Port the UI dev server (Vite) listens on
+UI_PORT=5173
+
+# -----------------------------------------------------------
+# Bot
+# -----------------------------------------------------------
+# Re-register slash commands with Discord on every startup
+FORCE_COMMAND_REGISTER=false
+
+# -----------------------------------------------------------
+# Data (Optional)
+# -----------------------------------------------------------
+# Path to a local directory for optional Siren Data integration
 DATA_DIR_PATH=./data
-
-FORCE_REGISTER=false
-DEFAULT_API_KEY=test_api_key
-DEFAULT_SERVER=
-DEFAULT_USER=