Dashboard
The Dashboard tab is a fully customisable monitoring canvas. Users create personal dashboards, place cards of different types onto a grid, and resize and rearrange them freely. It is designed for operators who need a purpose-built view - for example, a screen for a specific server room combining a camera feed, a door sensor, and a live event log.
Managing dashboards
- Multiple dashboards - users can create as many dashboards as they need.
- Ownership - only the owner can edit or delete a dashboard.
- Sharing - a dashboard can be kept private or shared with specific users or groups.
- Default dashboard - one dashboard can be marked as default; it opens automatically when the tab is entered.
- Dashboard groups - dashboards can be organised into a hierarchical group structure. The right-side panel shows the group/dashboard tree for quick switching.
Card types
| Card type | What it shows |
|---|---|
| Analog sensor | Sensor value with linear graph (Temperature, Humidity, Pressure, CO2, Voltage, Current, Power, Energy, and others) |
| Digital sensor | Binary ON/OFF state; output sensors can be toggled if the user has permission |
| Lock sensor | Lock / door state |
| CO2 sensor | CO2 concentration with alarm threshold indicators |
| Tilt sensor | Orientation / angle value |
| Video stream | Live camera feed; aspect ratio can be locked or free |
| Event grid | Live table of system events and alarms with configurable columns and filters |
Grid and layout
The dashboard uses a column-based grid with two layout modes:
| Mode | Behaviour | Best for |
|---|---|---|
| Fixed columns (Keep column ratio ON) | Always 12 columns; cards scale proportionally with screen width | Consistent look across all screen sizes |
| Adaptive columns (Keep column ratio OFF) | Column count grows on wider screens (approx. 85 px per column) | Large monitors where more cards should fit without scrolling |
Below 900 px screen width both modes collapse to a single-column stack.
Preset card sizes:
| Size | Grid units |
|---|---|
| Small | 4 × 3 |
| Medium | 8 × 6 |
| Large | 16 × 6 (full width) |
Cards can also be resized freely by dragging their resize handle.
Edit mode
All layout changes happen inside edit mode, toggled from the toolbar. On entering edit mode a snapshot of the current layout is saved so changes can be cancelled.
In edit mode:
- Drag cards to a new position; drag the resize handle to change dimensions.
- The grid auto-compacts - cards cannot overlap.
- For event grid cards, column visibility and order can be changed by drag-and-drop.
- Save writes all geometry changes in one request. Cancel restores the pre-edit snapshot.
- Navigating away with unsaved edits shows a confirmation dialog.
Toolbar actions
| Icon | Action | Description |
|---|---|---|
| Alarm count badge | Number of sensors in alarm on this dashboard; click to show only alarmed cards | |
| Edit toggle | Enter or exit edit mode | |
| Add dashboard | Open the create dashboard dialog | |
| Edit dashboard | Change name, description, and sharing settings (owner only) | |
| Delete dashboard | Delete with confirmation; navigates to the first remaining dashboard (owner only) | |
| Set as default | Mark or unmark this dashboard as the default opening view | |
| Arrange cards | Repacks all cards to best fit the current screen width (adaptive mode only) | |
| Resize all cards | Scale all cards on the canvas up or down uniformly |
Event grid card
The event grid card embeds a live event log directly on the canvas. Events refresh every 15 seconds.
Columns (user-selectable): Log code · Timestamp · Alarm name · Location · Info · Controller name · Bus name · Camera name · Peripheral type · Peripheral name · IP address
Filters: Location · Alarm type · User · Device · Sensor · Camera · Time period · Flagged events · Read / Unread · Has notes
Data refresh
The dashboard polls for updated sensor values, camera frames, and device status every 5 seconds. Polling continues in edit mode so values stay current while rearranging cards.
See also: Introduction | Cards | Map