Understanding the Dashboard

Last updated March 14, 2026


Dashboard Layout

The dashboard is your central control panel. It is organized into several areas:

Header Bar

  • Device selector — Switch between your registered Raspberry Pi devices
  • Search bar — Filter dashboard cards by name or type
  • Notification bell — View alerts and alarm events (unread badge shows count)
  • User menu — Account settings, unit preferences, and sign out

Room Tabs

Dashboard cards are organized by rooms — the same rooms you create in the Configurator. Each room gets its own tab with a customizable icon. You can reorder rooms and rename them inline.

Card Grid

Each room tab contains a grid of cards:

  • SensorStat — Live sensor readings with sparkline trends, alarm indicators, and threshold editor
  • ActuatorToggle — On/off control for relays and switches with staleness indicators
  • SetpointInput — Numeric input for PID controller setpoints
  • PID Indicator — Shows PID controller status (enabled/disabled, current output)
  • CameraViewer — Time-lapse camera widget

Cards can be hidden, rearranged, and resized. Your layout is saved automatically.

Key Features

Real-Time Data

All sensor readings update in real time via Firebase RTDB subscriptions. There is no manual refresh needed — when the Pi publishes a new reading, it appears on your dashboard within milliseconds.

Alarm Thresholds

Click any SensorStat card to configure alarm thresholds:

  • Warning — Yellow indicator when the reading crosses a threshold
  • Critical — Red indicator with optional email/SMS notification
  • Hysteresis — Configurable dead-band to prevent alert flapping

Analytics

Access historical data from the Analytics section in the sidebar. Features include:

  • Multi-signal overlay charts
  • Configurable time ranges (1 hour to 30 days)
  • LTTB downsampling for smooth rendering of large datasets
  • Signal selection panel

Activity Timeline

The Activity section shows a chronological log of events:

  • Deploy events
  • Alarm triggers and acknowledgments
  • Configuration changes
  • Device online/offline transitions

Device Health

Monitor your Pi system metrics from the Device Health panel:

  • CPU temperature and usage
  • Memory utilization
  • Disk space
  • Uptime
  • Threshold alerts for system resource warnings

Mobile Experience

The dashboard is a Progressive Web App (PWA) that can be installed on your phone:

  1. Open the dashboard in your mobile browser
  2. Tap Add to Home Screen (or the install prompt)
  3. The app launches in full-screen mode with:
    • Swipe navigation between rooms
    • Quick action floating button
    • Pull-to-refresh for manual data refresh

Next Steps

dashboardoverviewnavigation