.env.example

# ─── Backend env vars ────────────────────────────────────────
# Copy this file to `.env` and fill in real values.
# DO NOT commit `.env` to git.

# OneBusAway API key — request at https://onebusaway.org/contact/
OBA_API_KEY=your-oba-api-key-here

# Firebase Admin SDK
# Local dev: point to a downloaded service account JSON file.
GOOGLE_APPLICATION_CREDENTIALS=./service-account.json
# Production on GCP: just set the project ID and use workload identity.
FIREBASE_PROJECT_ID=your-firebase-project-id

# Database — defaults to sqlite:///tm-instance/data.db if unset.
# For Postgres: postgresql+psycopg2://user:pass@host:5432/dbname
SQLALCHEMY_DATABASE_URI=

# Comma-separated list of origins allowed to call /api/*.
# Leave blank in production to deny all (CORS off). Set to "*" only in dev.
ALLOWED_ORIGINS=https://your-frontend.example.com

# Server
FLASK_PORT=8880
FLASK_DEBUG=0
FLASK_ENV=production

# Logging — DEBUG | INFO | WARNING | ERROR
LOG_LEVEL=INFO
# Log format — `json` for production (Fly/Loki/Datadog ingest), `text` for local dev.
LOG_FORMAT=text

# Gunicorn — keep this low; --preload shares OBA data across workers.
# 4 is a good default for a 1-CPU Fly machine. Bump if you scale up.
WEB_CONCURRENCY=4
GUNICORN_TIMEOUT=30

# Skip the boot-time OneBusAway preload AND the in-process background
# loader started by bin/start. Useful when running tests or running the
# app against a pre-populated DB.
#SKIP_DATA_LOAD=0
#SKIP_DB_UPGRADE=0

# Rate limiting backend. Default "memory://" is per-process — fine for a
# single gunicorn worker, but with WEB_CONCURRENCY>1 the limits become
# per-worker. For true global limits, point at Redis: redis://host:6379
RATELIMIT_STORAGE_URI=memory://

# Optional fallback (legacy): SQLALCHEMY_DATABASE_URI takes precedence.
#DATABASE_URL=

# ─── Sentry (backend) ────────────────────────────────────────
# DSN from Sentry → transit-explorer-backend project → Settings → Client Keys.
# Leave blank to disable error reporting.
SENTRY_DSN=
# Defaults to FLASK_ENV. Override if you want a custom Sentry environment label.
#SENTRY_ENVIRONMENT=production
# Set to a release identifier (e.g. git sha) to tag events. Optional.
#SENTRY_RELEASE=
# Performance tracing sample rate (0.0–1.0). Default 0.1 in prod, 0 elsewhere.
#SENTRY_TRACES_SAMPLE_RATE=0.1