# shell-docs environment variables. # # All values below are read at REQUEST time (not at build time) — a # single built artifact can serve staging and prod by pointing them at # different hosts. See src/lib/runtime-config.ts for the authoritative # resolution rules; the summary below is a quick reference. # # URL-FATAL semantics: missing in production logs a `FATAL-CONFIG:` # error (Sentry-alerted) and falls back to a sentinel URL (visible # breakage) or — for fields with a working prod default — a non-fatal # warn and the default. Analytics-KEY semantics: missing is the empty # string with NO log (consumers no-op on empty). # # Severity by field: # FATAL-CONFIG on miss: NEXT_PUBLIC_BASE_URL, NEXT_PUBLIC_SHELL_URL # Non-fatal warn on miss (working prod default): # NEXT_PUBLIC_INTELLIGENCE_SIGNUP_URL, # NEXT_PUBLIC_POSTHOG_HOST # Silent ("" empty default, no log): # NEXT_PUBLIC_POSTHOG_KEY, # NEXT_PUBLIC_SCARF_PIXEL_ID, # NEXT_PUBLIC_GOOGLE_ANALYTICS_TRACKING_ID, # NEXT_PUBLIC_REB2B_KEY, # NEXT_PUBLIC_REO_KEY # Canonical base URL used by sitemap.ts, robots.ts, and the per-page # canonical metadata. In production this points at the docs host so # crawlers index every framework variant at its self-canonical URL. # FATAL on miss in prod, falls back to the canonical prod host # (https://docs.copilotkit.ai). NEXT_PUBLIC_BASE_URL=https://docs.copilotkit.ai # URL of the showcase shell host, which owns /integrations and /matrix. # Used by the top-nav cross-host links and InlineDemo. Replace with your # deployment's shell host. FATAL on miss in prod, falls back to the # sentinel `about:blank#shell-url-missing` (visible breakage). NEXT_PUBLIC_SHELL_URL=https://www.copilotkit.ai # Intelligence platform signup URL — drives the signup-link CTA and the # ops-platform-cta. Non-fatal warn on miss in prod; falls back to # https://dashboard.operations.copilotkit.ai/ which is a real working # host, so absence is recoverable. # NEXT_PUBLIC_INTELLIGENCE_SIGNUP_URL=https://dashboard.operations.copilotkit.ai/ # PostHog host — analytics destination for `posthog-js`. Non-fatal warn # on miss in prod; falls back to https://eu.i.posthog.com (the EU cloud # default that matches prior middleware behavior). # NEXT_PUBLIC_POSTHOG_HOST=https://eu.i.posthog.com # Analytics keys — empty string disables that analytics channel. # Legitimately absent in non-production envs; NO log on miss. # NEXT_PUBLIC_POSTHOG_KEY= # NEXT_PUBLIC_SCARF_PIXEL_ID= # NEXT_PUBLIC_GOOGLE_ANALYTICS_TRACKING_ID= # NEXT_PUBLIC_REB2B_KEY= # NEXT_PUBLIC_REO_KEY=