Dashboard

What this surface is

The dashboard is the landing page after login. It surfaces the recommended loop’s current state (where you are in the cycle), top-line KPIs (collection size, active decks, missing-card count), and quick navigation to the most useful surfaces for that moment.

Where to find it in the app

The root route /. Always one click from anywhere via the logo or “Home” in the main nav.

Screenshot pending /img/docs/reference/dashboard-overview.png

The dashboard summarizes the current loop state and surfaces the next action.

Layout

Region	Purpose
Loop tile	Visual of the 6-step loop with current step highlighted
KPI cards row	Collection size, active decks, missing cards, buy-list value
Maintenance checklist	Quick-action items for the weekly pass
Recent activity	Last N changes — saves, analyses, purchases reconciled
Quick links	Direct shortcuts to Inventory, Decks, Acquisition

KPI cards

KPI	Definition	Source
Collection size	Total unique cards in inventory	Inventory aggregate
Total copies	Sum of quantities across all cards	Inventory aggregate
Active decks	Decks not archived	Deck Lab count
Buildable now	Active decks with green Buildable badge	Aggregated readiness
Total missing	Sum of missing copies across all active decks	Aggregated shortage
Buy-list value	Estimated cost to close all shortages	Acquisition aggregate

KPI cards display a small delta vs the previous week when historical state is available.

Loop tile

The loop tile shows the 6-step recommended loop (Inventory → Add cards → Build decks → Analyze → Acquire → Compare) with the current step highlighted based on the most recent activity. Clicking a step navigates to that surface.

Step	Routes to
1. Inventory	/inventory
2. Add cards	/inventory/add
3. Build decks	/decks
4. Analyze	/decks (then pick a deck)
5. Acquire	/acquisition
6. Compare	/compare

Maintenance checklist

Item	Action
Triage inbox (N pending)	Routes to /inventory?location=inbox
Verify uncertain quantities	Routes to filtered inventory
Reconcile recent purchases	Routes to acquisition with “received” filter
Re-run readiness	Triggers a refresh
Archive stale decks (N candidates)	Opens deck filter

Each item shows a counter when the action has open work; greys out when clear. The full list lives in Recommended workflow.

Last-reconciled indicator

A timestamp showing the last time inventory was meaningfully updated. Color-coded:

Color	Meaning	When
Green	Fresh	Within 7 days
Amber	Getting stale	8-21 days
Red	Stale	>21 days — acquisition recommendations are unreliable

Interactions

• Click a loop tile step → navigates to that surface
• Click a KPI card → drills into the underlying list
• Click a maintenance item → opens the targeted action
• Click last-reconciled → opens the maintenance modal

States and badges

Badge	Meaning
”Welcome back” callout	First visit in >7 days
”Sync issue” indicator	Inventory snapshot lags by >5 minutes (rare; usually a Postgres / API lag)
Empty-state hero	No cards in inventory — CTA to import
Onboarding callout	New account — links to Quick start

Edge cases

Caution

• Last-reconciled never updates — usually means you’re only viewing/reading and not editing. Make any inventory change to refresh.
• KPI weekly-delta missing when historical snapshots haven’t accumulated yet (new accounts under 14 days).
• Loop step “stuck” on the same one — Pegasus infers current step from recent activity; if you only do one step type, the loop never advances. Run a different workflow to update inference.

Related workflows

Recommended workflow The end-to-end loop the dashboard tracks.

Related references

• Inventory — where the maintenance items route
• Acquisition — what the buy-list KPI summarizes
• Deck Lab — where active-decks KPI sources from