.env.example

# Google Analytics 4 measurement ID (optional). Create at https://analytics.google.com/
NEXT_PUBLIC_GA_MEASUREMENT_ID=G-XXXXXXXXXX

# Mapbox public token (map display). Create at https://account.mapbox.com/
# Restrict URLs to http://localhost:3000/* and your Vercel deployment domain.
NEXT_PUBLIC_MAPBOX_ACCESS_TOKEN=pk.your_token_here

# Google AI API key for the lore agent (server-only). Create at https://aistudio.google.com/apikey
GOOGLE_GENERATIVE_AI_API_KEY=your_key_here

# Lore models: every search uses LORE_MODEL_ID; fallbacks only on 503/502/504 (not 429/403).
LORE_MODEL_ID=gemini-3.1-flash-lite
LORE_MODEL_FALLBACK_IDS=gemini-2.5-flash,gemini-2.5-flash-lite

# QStash (https://console.upstash.com/qstash)
QSTASH_TOKEN=
QSTASH_CURRENT_SIGNING_KEY=
QSTASH_NEXT_SIGNING_KEY=

# Ephemeral job state + global recent-search leaderboard (https://console.upstash.com/redis) — NOT geographic cache
UPSTASH_REDIS_REST_URL=
UPSTASH_REDIS_REST_TOKEN=

# Supabase geographic lore cache (https://supabase.com) — run supabase/migrations/001_lore_cards.sql
NEXT_PUBLIC_SUPABASE_URL=
SUPABASE_SERVICE_ROLE_KEY=

# Worker callback base URL for production / cloud QStash
LORE_APP_URL=https://local-lore.ajayliu.com

# Optional: override callback URL when using local QStash (qstash-cli dev). If unset,
# development + QSTASH_URL=http://127.0.0.1:8080 defaults to http://127.0.0.1:3000
# LORE_APP_URL_LOCAL=http://127.0.0.1:3000