env vars

.env.development

@@ -1,45 +1,84 @@
 # ==========================================
 # GridPilot Development Environment
 # ==========================================
+# Used by `docker-compose.dev.yml` via `env_file: .env.development`.
 
-# Node Environment
+# ------------------------------------------
+# Runtime
+# ------------------------------------------
 NODE_ENV=development
+NEXT_TELEMETRY_DISABLED=1
+
+# ------------------------------------------
+# API (NestJS)
+# ------------------------------------------
+# API persistence is inferred from DATABASE_URL by default.
+# GRIDPILOT_API_PERSISTENCE=postgres
 
-# ==========================================
-# Database (PostgreSQL)
-# ==========================================
 DATABASE_URL=postgres://gridpilot_user:gridpilot_dev_pass@db:5432/gridpilot_dev
+
+# Postgres container vars (used by `docker-compose.dev.yml` -> `db`)
 POSTGRES_DB=gridpilot_dev
 POSTGRES_USER=gridpilot_user
 POSTGRES_PASSWORD=gridpilot_dev_pass
 
-# ==========================================
-# API Configuration
-# ==========================================
-API_PORT=3000
-API_HOST=0.0.0.0
-
-# ==========================================
-# Website Configuration
-# ==========================================
+# ------------------------------------------
+# Website (Next.js) - public (exposed to browser)
+# ------------------------------------------
 NEXT_PUBLIC_GRIDPILOT_MODE=alpha
 NEXT_PUBLIC_SITE_URL=http://localhost:3000
-NEXT_PUBLIC_API_URL=http://localhost:3001
-NEXT_PUBLIC_API_BASE_URL=http://localhost:3001
-NEXT_PUBLIC_DISCORD_URL=https://discord.gg/your-invite-code
-NEXT_TELEMETRY_DISABLED=1
 
-# ==========================================
-# Vercel KV (Optional in Development)
-# ==========================================
+# Browser → API base URL (host port 3001 -> container port 3000)
+NEXT_PUBLIC_API_BASE_URL=http://localhost:3001
+
+NEXT_PUBLIC_DISCORD_URL=https://discord.gg/your-invite-code
+NEXT_PUBLIC_X_URL=https://x.com/your-handle
+
+# Optional site/legal metadata (defaults used when unset)
+# NEXT_PUBLIC_SITE_NAME=GridPilot
+# NEXT_PUBLIC_SUPPORT_EMAIL=support@example.com
+# NEXT_PUBLIC_SPONSOR_EMAIL=sponsors@example.com
+# NEXT_PUBLIC_LEGAL_COMPANY_NAME=
+# NEXT_PUBLIC_LEGAL_VAT_ID=
+# NEXT_PUBLIC_LEGAL_REGISTERED_COUNTRY=
+# NEXT_PUBLIC_LEGAL_REGISTERED_ADDRESS=
+
+# ------------------------------------------
+# Vercel KV (optional in dev)
+# ------------------------------------------
+# If unset, the Website uses an in-memory fallback with a warning.
 # KV_REST_API_URL=
 # KV_REST_API_TOKEN=
 
-# ==========================================
-# Automation Mode
-# ==========================================
-AUTOMATION_MODE=dev
+# ------------------------------------------
+# Automation / Companion (advanced)
+# ------------------------------------------
+# Prefer using NODE_ENV=development/test. `AUTOMATION_MODE` is legacy & deprecated.
+# AUTOMATION_MODE=dev
 CHROME_DEBUG_PORT=9222
+# CHROME_WS_ENDPOINT=ws://127.0.0.1:9222/devtools/browser/<id>
+
+# Native automation tuning (optional)
+# IRACING_WINDOW_TITLE=iRacing
+# TEMPLATE_PATH=./resources/templates/iracing
+# OCR_CONFIDENCE=0.9
+# NUTJS_MOUSE_SPEED=1000
+# NUTJS_KEYBOARD_DELAY=50
+# AUTOMATION_MAX_RETRIES=3
+# AUTOMATION_BASE_DELAY_MS=500
+# AUTOMATION_MAX_DELAY_MS=5000
+# AUTOMATION_BACKOFF_MULTIPLIER=2
+# AUTOMATION_PAGE_LOAD_WAIT_MS=5000
+# AUTOMATION_INTER_ACTION_DELAY_MS=200
+# AUTOMATION_POST_CLICK_DELAY_MS=300
+# AUTOMATION_PRE_STEP_DELAY_MS=100
+
 AUTOMATION_TIMEOUT=30000
 RETRY_ATTEMPTS=3
 SCREENSHOT_ON_ERROR=true
+
+# Logging (automation/adapters)
+# LOG_LEVEL=debug
+# LOG_FILE_PATH=./logs/gridpilot
+# LOG_MAX_FILES=7
+# LOG_MAX_SIZE=10m