🔍⌘K

Start typing to search docs.

Analytics & Observability

1.0.0

Event tracking, dashboards, and KPIs across tenants.

Event tracking

  • The landing app and dashboard call helpers in apps/landing/src/lib/analytics.ts and common/lib/analytics.
  • trackEvent delegates to @vercel/analytics and logs in development.
  • Add new event enums before instrumenting new flows.
EventDescription
docs_page_viewedEmitted via <DocsAnalyticsTracker /> whenever a doc renders.
docs_searchLogged when users trigger search queries.
paywall_viewedFired from the paywall when enterprise gating blocks access.

Success

Events are thin wrappers over Vercel Analytics. Layer other providers by extending trackEvent without touching callers.

Reporting

  1. Export raw events from Vercel Analytics into your data warehouse.
  2. Join docs search events with Supabase org data to understand enterprise engagement.
  3. Feed plan + usage metrics back into the dashboard via the Forge API.

Health checks

  • pnpm test:smoke verifies top-level routes.
  • ./docs/scripts/health-check.sh pings Supabase, Stripe, and Vercel endpoints.

Warning

Always gate enterprise-only analytics with Supabase session checks. Avoid emitting doc metrics for anonymous users viewing gated content.