.env.example

# Copy to `.env` (or set via your shell) to enable optional integrations.
# `.env`, `.env.local`, and `.env.production` are all gitignored.
#
# Values below are PUBLIC (they're shipped to the browser by Astro's
# `envField`, and live behind rate limiting / allow-lists on the vendor side).

# Kapa Website Widget integration ID for the "Ask AI" button in the sidebar.
# If unset, docs falls back to the shared widget integration ID used in preview/prod.
# Get yours at: https://app.kapa.ai/admin (Integrations → Widget → Copy integration ID).
# The same value is passed to the widget as `data-website-id`.
# PUBLIC_KAPA_INTEGRATION_ID=f31c5644-dd65-4f49-9762-bf580062afa8
PUBLIC_KAPA_INTEGRATION_ID=

# Optional Kapa project ID used to build internal conversation links in
# "Create ticket" email drafts:
#   https://app.kapa.ai/<PROJECT_ID>/conversations/<THREAD_ID>
# You can find this in the Kapa dashboard URL while viewing the project.
PUBLIC_KAPA_PROJECT_ID=

# RudderStack analytics — required for docs_404 event tracking and page analytics.
# Without these, no analytics events are sent and the weekly 404 monitor will
# report zero data. Set both in the Vercel project environment (all environments).
#
# PUBLIC_RUDDERSTACK_WRITE_KEY: Source write key from the RudderStack dashboard
#   (Sources → your docs source → Write Key).
# PUBLIC_RUDDERSTACK_DATA_PLANE_URL: Data plane endpoint. Currently proxied
#   through https://app.warp.dev — do NOT change to a direct
#   *.dataplane.rudderstack.com URL without also updating the connect-src
#   directive in vercel.json (a mismatch silently blocks all events in the browser).
PUBLIC_RUDDERSTACK_WRITE_KEY=
PUBLIC_RUDDERSTACK_DATA_PLANE_URL=

# Server-side handoff forwarding endpoint used by /api/support-handoff.
# This should point at the DevX service endpoint that creates Front
# conversations from docs chat handoff requests.
SUPPORT_HANDOFF_ENDPOINT_URL=

# Required when SUPPORT_HANDOFF_ENDPOINT_URL is set. Docs forwards this only
# to the DevX service as the `?secret=` query parameter, not as a bearer token.
SUPPORT_HANDOFF_SHARED_SECRET=