Cluster Dashboard

Overview of the main dashboard view showing all clusters

The dashboard is the main landing page of the platform. It displays all ClusterPersona resources in a table with key status information at a glance.

At v0.0.1 the dashboard covers ClusterPersona only — incidents and remediations are not visualized here yet.

Dashboard view

The cluster table shows:

Column	Description
Name	Cluster name (clickable — navigates to detail view)
Environment	Environment tag from spec.environment (e.g., production, staging)
Status	Phase badge with color coding
Nodes	Total node count
Description	Truncated cluster description

Status badges

Clusters display a color-coded status badge based on their phase:

Phase	Color	Meaning
Ready	Green	All nodes healthy, discovery complete
Pending	Blue	Initial discovery in progress
Degraded	Yellow	Some nodes not ready
Failed	Red	Discovery failed
Unknown	Gray	Status not yet determined

Navigation

Click any cluster row to navigate to the cluster detail view for that cluster.

Data fetching

The dashboard uses React Query to fetch cluster data:

• Stale time: 10 seconds — data is considered fresh for 10s before refetching
• Background refetch: Disabled on window focus to avoid unnecessary API calls
• Retry: 1 retry on failure

Data is also automatically refreshed when the WebSocket connection receives a cluster event. See real-time updates for details.

States

The dashboard handles three states:

State	Display
Loading	Skeleton placeholders in table rows
Error	Alert banner with error message
Empty	”No clusters found” message

Cluster detail

Detailed view of a single cluster

Real-time updates

How live updates work