Analytics Dashboard Zero-State: Guiding New Organisations

Introduced in: v0.1.272

Overview

When a new organisation first opens the Analytics dashboard, no deposit release data exists yet. Rather than displaying a confusing array of blank charts and — placeholders, the dashboard now detects this condition and shows a focused empty state with clear guidance on what to do next.

How It Works

The dashboard checks summary.totalReleases. If the value is 0 (i.e. no deposit releases have been completed for the organisation), the standard chart and KPI layout is replaced with an empty-state page.

summary.totalReleases === 0
  → Hide all charts and KPI cards
  → Render full-page zero-state coaching UI

summary.totalReleases > 0
  → Render normal dashboard (KPI cards, charts, Problem Properties table)

What the Empty State Shows

Headline message

Your analytics will populate once you complete your first deposit release.

Preview cards

Three illustrated cards (or preview screenshots) give a visual indication of what the dashboard will look like once data exists, covering the 6 KPI categories:

Deposit releases completed
Average release time
Dispute rate
Deduction acceptance rate
Compliance score
Problem properties

Call-to-action buttons

Button	Destination	Purpose
Add Properties	Property setup	Register the properties whose tenancies will generate release data
Create Tenancy	New tenancy form	Attach tenants and deposit details to a property
Start Deposit Release	Deposit release workflow	Begin the end-of-tenancy process that drives all analytics metrics

Why the Charts Are Hidden

Showing empty charts to a user who has no data is misleading — it implies something went wrong rather than that the product is simply waiting for input. Hiding the charts until data exists keeps the interface clear and directs attention to the actions that will populate it.

Relationship to KPI Tooltips

Each KPI card on the populated dashboard carries a tooltip explaining what the metric measures. Those tooltips are unchanged. The empty state complements them by explaining how to generate the underlying data, not just what the data means.

Affected File

src/app/dashboard/analytics/analytics-dashboard.tsx