.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 CUSTOM_FRONTEND integration ID for the custom "Ask AI" React chat
# (KapaChatLauncher / @kapaai/react-sdk). If unset, the custom chat launcher
# is omitted. Get yours at: https://app.kapa.ai (Integrations → custom frontend).
# Do not reuse this value for WebMCP — that needs a Website Widget integration.
PUBLIC_KAPA_INTEGRATION_ID=

# Kapa Website Widget integration ID for WebMCP only. Emitted as
# data-website-id on the official widget script with data-webmcp-enabled=true
# so in-browser agents can call search_warp_knowledge_sources. If unset, the
# WebMCP script is omitted. The default floating Ask button stays hidden
# (data-button-hide); the custom sidebar Ask control remains the human entry
# point. Get yours at: https://app.kapa.ai (Integrations → Website Widget).
# Live Docs Bot example: "Docs Widget" (type WIDGET).
PUBLIC_KAPA_WEBSITE_WIDGET_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=