.env.example

# ─── Local Development ───────────────────────────────
# Copy this file to .env and fill in values.
# `make dev` loads .env automatically.
#
# Only DATABASE_URL is required to start the server.
# Everything else is optional — the server runs fine without
# Vertex, Stripe, or Google OAuth.

# ─── Required ────────────────────────────────────────

# Postgres (local Docker — matches docker-compose.yml defaults)
DATABASE_URL=postgresql://hanzi:hanzi_dev@localhost:5433/hanzi

# Better Auth (required for dashboard sign-in)
# Change BETTER_AUTH_SECRET to any random string in production.
BETTER_AUTH_SECRET=dev-secret-change-in-production
BETTER_AUTH_URL=http://localhost:3456

# ─── Optional ────────────────────────────────────────

# Google OAuth (for "Sign in with Google" on dashboard)
#   1. Go to https://console.cloud.google.com/apis/credentials
#   2. Create an OAuth 2.0 Client ID (Web application)
#   3. Add authorized redirect URI: http://localhost:3456/api/auth/callback/google
#   4. Copy the Client ID and Client Secret here
# GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com
# GOOGLE_CLIENT_SECRET=GOCSPX-your-secret

# Stripe (for credit purchase flow)
#   1. Go to https://dashboard.stripe.com/test/apikeys
#   2. Use test mode keys for development
# STRIPE_SECRET_KEY=sk_test_your-test-key
# STRIPE_WEBHOOK_SECRET=whsec_your-webhook-secret
# STRIPE_CREDIT_PRICE_ID=price_your-price-id
# STRIPE_CREDIT_PACK_1=100:price_pack1
# STRIPE_CREDIT_PACK_2=500:price_pack2
# STRIPE_CREDIT_PACK_3=1500:price_pack3

# Vertex AI (for managed task execution — the AI that drives browser tasks)
#   Without this, the server runs but managed tasks won't execute.
#   To set up:
#   1. Create a GCP project at https://console.cloud.google.com
#   2. Enable the Vertex AI API
#   3. Create a service account with "Vertex AI User" role
#   4. Download the JSON key file and save it (e.g., ../vertex-sa.json)
#   5. Set the path below (relative to project root or absolute)
# VERTEX_SA_PATH=../vertex-sa.json

# Sentry (error tracking for managed backend)
# SENTRY_DSN=https://xxx@xxx.ingest.sentry.io/xxx

# PostHog (product analytics for managed backend)
# POSTHOG_API_KEY=phc_xxx