Customer / Usage Dashboard

Generated 2026-05-10T00:35:21Z — pre-launch scaffold ·

Pre-launch: telemetry not yet wired. All panels show empty-state placeholders.
To wire: set TELEMETRY_ENDPOINT repository secret + TELEMETRY_ENABLED=true in .github/workflows/usage-dashboard-update.yml, then re-run the workflow.

DAU / MAU

DAU / MAU — panel ready, awaiting data
Awaiting telemetry — set TELEMETRY_ENDPOINT secret and flip TELEMETRY_ENABLED=true in the workflow to wire this panel.

Retention Cohorts (D1 / D7 / D30)

D1/D7/D30 Retention Cohorts — panel ready, awaiting data
Awaiting telemetry — set TELEMETRY_ENDPOINT secret and flip TELEMETRY_ENABLED=true in the workflow to wire this panel.

Feature Usage Funnel

Feature Usage Funnel (split inbox / calendar AI / notes) — panel ready, awaiting data
Awaiting telemetry — set TELEMETRY_ENDPOINT secret and flip TELEMETRY_ENABLED=true in the workflow to wire this panel.

New-User Onboarding Funnel

New-User Onboarding Funnel — panel ready, awaiting data
Awaiting telemetry — set TELEMETRY_ENDPOINT secret and flip TELEMETRY_ENABLED=true in the workflow to wire this panel.

How to Wire Telemetry

  1. Implement a /metrics API endpoint that returns JSON matching the schema in scripts/generate-usage-dashboard.sh (see "Telemetry schema" header comment).
  2. Add the endpoint URL as a repository secret named TELEMETRY_ENDPOINT:
    gh secret set TELEMETRY_ENDPOINT --body "https://your-api/metrics"
  3. In .github/workflows/usage-dashboard-update.yml, set the env var:
    TELEMETRY_ENABLED: 'true'
  4. Trigger the workflow manually (Actions → Usage Dashboard Update → Run workflow) to verify the panels populate.
  5. Remove this "How to Wire" section from the HTML once the dashboard is live (or leave it for reference).