env.example

# =====================================================================
# Copy this file to `.env.local` and fill in the values.
# =====================================================================

# --- Demo mode (no auth) ---
# This build has no sign-in — every visitor sees all generated lessons.
# DEMO controls whether visitors can GENERATE lessons:
#   on  -> uploading + generating PDFs is allowed
#   off -> explore-only (watch existing lessons; upload/delete disabled)
# The client reads NEXT_PUBLIC_DEMO; the Convex backend reads DEMO
# (set it with `npx convex env set DEMO on`). Keep the two values in sync.
NEXT_PUBLIC_DEMO=on
DEMO=on

# --- Convex (database + backend) ---
# Get from: `npx convex dev` (it will create a project and print the URL)
NEXT_PUBLIC_CONVEX_URL=https://your-project.convex.cloud
# Convex deployment name (auto-populated by `npx convex dev`)
CONVEX_DEPLOYMENT=

# --- Google Vertex AI (LLM + TTS) ---
# Path to your service-account JSON key file (relative to project root, e.g. ./gcp-service-account.json)
# Alternatively set GOOGLE_APPLICATION_CREDENTIALS to an absolute path.
GOOGLE_APPLICATION_CREDENTIALS=./gcp-service-account.json
# Your GCP project ID
GCP_PROJECT_ID=your-gcp-project-id
# Vertex AI location. `global` is required for the newest Gemini model aliases
# used by this project, matching the Doodly integration.
GCP_LOCATION=global
# Vertex AI Gemini model names.
GEMINI_MODEL=gemini-3.5-flash
# Gemini TTS is the fallback narration voice (used only if Cloud TTS below is
# disabled or fails). Voice names: Kore, Puck, Charon, Fenrir, Aoede.
GEMINI_TTS_MODEL=gemini-3.1-flash-tts-preview
GEMINI_TTS_VOICE=Kore

# Google Cloud Text-to-Speech is the primary narration voice. Narration is
# synthesized one plain-text clip per speech action (no SSML, no mark
# timepoints) so each highlight stays locked to its own clip. Chirp 3 HD is
# the most natural voice family. Uses the same service-account JSON as Vertex
# AI; enable the Cloud Text-to-Speech API (texttospeech.googleapis.com) first.
GOOGLE_CLOUD_TTS_ENABLED=true
GOOGLE_CLOUD_TTS_VOICE=en-US-Chirp3-HD-Achernar
GOOGLE_CLOUD_TTS_LANGUAGE=en-US
GOOGLE_CLOUD_TTS_AUDIO_ENCODING=MP3