.env.example

# Adaptive Learner environment variables
# Copy to .env and adjust values for your deployment.

# --- Ports ---
#
# Backend dev port. Read by the Makefile (`make dev`), the e2e
# Playwright config, Docker compose, and the frontend Vite proxy
# (which routes /api requests to `http://localhost:$ADAPTIVE_LEARNER_PORT`).
# Default is intentionally non-standard so Adaptive Learner can
# coexist with other projects already bound to :8000 on the same
# workstation.
ADAPTIVE_LEARNER_PORT=18001

# Frontend dev port (vite). Read by vite.config.ts, the Makefile,
# the e2e Playwright config, and the dev docker-compose port
# mapping. Non-standard so it doesn't collide with :5173.
ADAPTIVE_LEARNER_FRONTEND_PORT=15174

# Production host-published port (docker-compose.prod.yml). This is
# the port the frontend nginx container is mapped to on the host;
# distinct from the dev ports above because prod uses an nginx
# reverse-proxy in front of the static build, not vite dev server.
ADAPTIVE_LEARNER_PUBLIC_PORT=8501

# --- Behaviour ---
#
# Debug mode. Disables /api/test/reset endpoint and the auto-mounted
# API docs (/api/docs) when false.
ADAPTIVE_LEARNER_DEBUG=false

# CORS origins. Comma-separated list of allowed frontend URLs.
# Overrides the ``server.cors_origins`` list in backend/config/app.yaml.
# Default for dev = http://localhost:$ADAPTIVE_LEARNER_FRONTEND_PORT
ADAPTIVE_LEARNER_CORS_ORIGINS=http://localhost:15174

# Encryption key for stored user API keys (Phase 1C crypto service).
# Generate one with:
#   python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"
# Required; the FastAPI app refuses to start without it.
ADAPTIVE_LEARNER_SECRET_KEY=

# --- Optional / advanced ---
#
# Database URL override (otherwise derived from ADAPTIVE_LEARNER_DATA_DIR
# via platformdirs). For PostgreSQL:
# DATABASE_URL=postgresql://user:password@host:5432/adaptive_learner
# DATABASE_URL=sqlite:////app/data/adaptive_learner.db