Skip to content

Dashboard Reference

The Dashboard is the home screen of ntkDeploy. It provides a real-time snapshot of your fleet configuration data and one-click access to the most common actions.

Prerequisites

Layout

The Dashboard is divided into four areas rendered top-to-bottom:

Area Location Purpose
Quick Actions Top One-click entry points for common tasks
Statistics Below Quick Actions Fleet-wide entity counts
Recent Activity Bottom-left (2/3 width) Last 10 audit log events
Warnings Bottom-right (1/3 width) Active issues requiring attention

Quick Actions Card

Four buttons are always visible at the top of the Dashboard:

Button Shortcut Action
Create Profile Ctrl+N (when Profiles is active) Opens the new-profile wizard
Import Profile — Navigates to the Profiles section; import dialog is pending implementation
Create Device Group — Navigates to the Device Groups section
New Deployment — Navigates to the Deployment section

Tip: Pressing Ctrl+N anywhere in ntkDeploy triggers a context-sensitive "new" action. On the Dashboard it is linked to the Create Profile flow.

Statistics Card

The Statistics card shows live counts loaded from the local SQLite database in parallel when the Dashboard opens.

Metric What it counts
Total Profiles All profiles stored in the local database
Total Device Groups All device groups in the local database
Total Devices Sum of all UNC destination paths across every device group
Recent Deployments Successful rollouts (rollout_succeeded) recorded in the audit log
Total Providers Registered cloud provider instances
People Policy people records (displayed only when Policy Manager is configured)
Attributes ABAC attribute definitions (displayed only when Policy Manager is configured)

Statistics are fetched in parallel at page load. To refresh, navigate away and return to the Dashboard.

Recent Activity Card

Shows the 10 most recent audit log entries across all entity types.

Row Layout

Element Description
Icon (leading) Color-coded action type indicator
Title Action label and entity type concatenated (e.g., Profile Created profile)
Subtitle Date and time in MMM d, HH:mm format (e.g., Mar 3, 14:30)
Trailing Actor — user or system that triggered the event

Event Type Colors

Icon colors indicate the nature of each event at a glance:

Action type Icon color meaning
profile_created Primary accent color
profile_updated Tertiary accent color
assignment_created Secondary accent color
rollout_succeeded Primary accent color
rollout_failed Error color (red)
policy_capabilities_check Tertiary accent color
All other events Muted surface color

Theme-dependent: The exact hue for each color role is determined by the active app theme and its light/dark variant. Exact colors may differ between Light and Dark mode.

Note: The full Audit Log page uses a separate mapping with fixed colors; its icon hues differ from the Dashboard card. See Audit Log Reference for details.

For the full list of recorded event types and filtering options, see Audit Log Reference.

Warnings Card

The Warnings card is titled Warnings & Issues. In the current release it always displays a static "No warnings" state (green checkmark icon). No dynamic warning detection or remediation links are shown.

Error State

If the Dashboard fails to load (e.g., a database initialisation error), an error icon and message are shown in place of the statistics. Restart ntkDeploy; if the error persists, see Common Issues.

Next Steps