Notifications & Alerts

The UniFi Dashboard provides a proactive monitoring experience through a multi-sensory alert system. Instead of manually refreshing or digging through site logs, the dashboard automatically identifies changes in your network state and brings them to your attention.

Real-Time Client Tracking

The system monitors the total number of connected clients across all selected sites. Every 15 seconds, the dashboard compares the current client count against the previous state to detect changes.

Connection Alerts (📈): Triggered when new clients join the network. These appear with a green indicator.
Disconnection Alerts (📉): Triggered when clients leave the network. These appear with an orange indicator.

Each notification provides the delta (e.g., +2 clients) and the updated total client count for the entire infrastructure.

Visual Indicators

To ensure alerts are noticed even when the browser is not the primary focus, the dashboard employs two visual cues:

Notification Toast: A sliding card appears in the top-right corner of the screen. These notifications persist for a short duration to provide a recent history of activity during your session.
Stat Card Flashing: When a client count change is detected, the "Total Clients" card at the top of the dashboard will briefly flash. This highlights exactly which metric was updated during the last refresh cycle.

Audio Alerts

The dashboard includes an optional sound notification that plays whenever a client joins or leaves.

Toggling Sound: You can enable or disable audio alerts using the bell icon (🔔/🔕) located in the header controls.
Mute Persistence: The mute state is maintained during your active session, allowing you to monitor quietly in open-office environments or turn on sounds for background monitoring.

Auto-Refresh & Synchronization

Alerts are synchronized with the 15-second auto-refresh timer.

Countdown Timer: A countdown in the header indicates exactly when the next check will occur.
Manual Override: If you click "Refresh Data" manually, the system will immediately perform a comparison and trigger any necessary alerts based on the new data.

Configuration

The notification system is enabled by default. To manage how you receive updates, use the controls in the top-right header:

# Note: Notification timing is tied to the refresh cycle. 
# Ensure your UNIFI_API_URL is accessible to maintain consistent alert delivery.