N Nexus Docs
Foundation

Dashboard

Real-time command center for your multi-marketplace operation — stat cards, alerts, and onboarding progress.

Overview

The Dashboard is the first screen after login. It aggregates live data from all connected marketplaces into a single view, surfaces alerts requiring action, and guides new users through the onboarding checklist.

Data on the Dashboard refreshes every 60 seconds automatically. The last-refreshed timestamp is shown in the top-right corner of each stat card.

Key Concepts

Stat Cards — Summary metrics cards shown at the top of the Dashboard. Each card displays the current period value, a comparison to the previous period (as a percentage change), and a sparkline for trend visualization.

Alert Feed — A prioritized list of conditions requiring attention. Alerts are generated by background jobs and by the adapter sync layer. Alerts are dismissed by resolving the underlying condition (e.g., restocking a low-inventory SKU) or manually acknowledging them.

Onboarding Progress — A checklist card visible until all onboarding steps are complete. Shows completed steps (green), pending steps (neutral), and skipped steps (muted).

Getting Started

The Dashboard is available immediately after login. No configuration is required. As you connect marketplaces and import data, the stat cards populate automatically.

To customize which stat cards are visible, click the Customize button in the top-right of the Dashboard grid. Drag cards to reorder them.

Features

Stat Cards

The default stat card set:

CardMetricSource
Total RevenueSum of order totals (all marketplaces)orders table
Orders TodayCount of orders with created_at todayorders table
Return RateReturns / orders in last 30 daysreturns / orders
Inventory ValueSum of (unit_cost x quantity)inventory_items
Active ListingsCount of listings with status activemarketplace_listings
Buy Box Win RatePercentage of monitored ASINs winning Buy Boxbuy_box_history

Each card shows three time periods: today, last 7 days, last 30 days. Toggle between periods using the period selector above the card grid.

Revenue Sparkline

The revenue card includes a 30-day sparkline chart powered by ClickHouse analytics queries. The sparkline uses the daily_revenue materialized view for sub-second load times even on large order volumes.

Alert Feed

Alerts are organized into three severity levels:

  • Critical (red) — Requires immediate action (e.g., a marketplace connection has been rejected, a product is suspended)
  • Warning (amber) — Requires attention within 24 hours (e.g., stock below safety threshold, a repricing rule conflict)
  • Info (blue) — Informational (e.g., a sync completed with warnings, a new marketplace policy update)

Example critical alert:

Amazon US — Connection Error
Token expired. Re-authenticate to resume syncing.
[Reconnect] [Dismiss]

Example warning alert:

SKU-1042 (Blue Widget 500ml) — Low Stock
3 units remaining across all warehouses. Reorder threshold: 10 units.
[View Inventory] [Dismiss]

Onboarding Progress Card

Visible to all users until the tenant completes all onboarding steps. Shows:

  • Completed steps with a checkmark
  • Current step highlighted with a call-to-action button
  • Overall progress percentage

The card can be minimized but not hidden until all steps are complete. Owners can reset the onboarding checklist from Settings > General without affecting data.

Marketplace Status Row

Below the stat cards, a row of marketplace badges shows the status of each connection:

  • Green dot — Active, last sync within expected window
  • Amber dot — Sync delayed or running
  • Red dot — Connection error
  • Grey dot — No connection configured

Clicking a badge navigates to the Connections page filtered to that marketplace.

Recent Orders Table

A live table showing the 10 most recent orders across all marketplaces. Columns:

  • Order ID (linked to order detail)
  • Marketplace (icon + name)
  • Customer
  • Total
  • Status
  • Time ago

Configuration

Dashboard configuration options are accessed via the Customize button:

OptionDescription
Visible stat cardsChoose which of the 6 default cards to show
Card orderDrag to reorder the card grid
Alert filterFilter alert feed by severity level
Auto-refresh interval30s, 60s, 5m, or off
Default periodSet the default time period for stat cards