.env.example

# Required to paste your own Spotify playlist URL (single-playlist mode or
# Mixed Playlist Mode's room/phone submissions) — /api/playlist calls
# Spotify's Web API and needs these to authenticate. This is app-level
# Client Credentials, NOT a user login — no redirect URI, no Spotify account
# sign-in, and the player never sees a Spotify auth screen.
# Skip these only if you're just trying the 3 built-in trial playlists,
# which are bundled locally and never call the Spotify API.
# Get these at https://developer.spotify.com/dashboard
SPOTIFY_CLIENT_ID=
SPOTIFY_CLIENT_SECRET=

# Optional — defaults to https://www.guessong.app if unset
NEXT_PUBLIC_BASE_URL=

# Optional — enables GA4 when set
NEXT_PUBLIC_GA_MEASUREMENT_ID=

# Optional — the AdSense publisher id ("ca-pub-…"). Defaults to the project's
# own id, so set this only when running under a different AdSense account, and
# update public/ads.txt to match. The loader only renders in production builds.
NEXT_PUBLIC_ADSENSE_CLIENT_ID=

# Optional for local dev (falls back to an in-memory store), but REQUIRED on
# serverless/multi-instance deploys (e.g. Vercel) — backs the QR-code room
# store used by Mixed Playlist Mode (lib/kv.ts). Get a free database at
# https://upstash.com
UPSTASH_REDIS_REST_URL=
UPSTASH_REDIS_REST_TOKEN=

# Required for Buzzer Mode only. Points at the Cloudflare Worker in worker/,
# which hosts the live buzzer rooms as Durable Objects — Vercel serves the app,
# Cloudflare serves the rooms. Vercel cannot host these itself: its WebSocket
# connections are pinned to a single function instance and new connections are
# not guaranteed to land on the same one, so there is nothing to broadcast a
# room to. See the design doc's Distribution Plan.
#
# Local dev:  wrangler dev in worker/ prints a URL — use ws://127.0.0.1:8787
# Production: wss://guesssong-buzzer.<your-subdomain>.workers.dev
#
# Without it the app still runs; Buzzer Mode reports that rooms are unavailable
# rather than failing at connect time.
NEXT_PUBLIC_BUZZER_WS_URL=