Dashboards & Widgets

Every project has a dashboard canvas you assemble from widgets. Open a project and click Edit Canvas to enter edit mode; click Done Customizing when finished — the layout saves as you go.

Widget types

Widget	Best for
Line Chart	Trends over time — temperature through the day, moisture between waterings.
Bar Chart	Comparing recent readings side by side.
Gauge	A single value against its expected range, at a glance.
Value Card	The latest number, big and readable across a room.
Actuator Switch	Sending an on/off command topic to hardware like a pump or relay.
Alert Feed	A running log of triggered alerts inside the canvas.

In edit mode, click any widget type in the Widgets Inventory panel to append it to the canvas, then click the widget to open its properties.

Widget properties

Widget title — the label shown on the card.
Sensor field source — free text. Type any field name your device sends (temp, ph, tank_level…). Fields already seen from your devices appear as suggestions while you type.
Unit — pick from a dropdown of common symbols (°C, %, lx, ppm, hPa, V, m/s, …) or choose Custom… to type your own symbol.
Widget size — Sm, Md, or Lg to control how much of the grid the widget spans.

The field source is not limited to a preset list — if your firmware sends it, you can chart it. The suggestions are just shortcuts drawn from data your devices have already reported.

Live updates

Dashboards poll for fresh readings automatically, so charts move as data arrives — no manual refresh. The status pill in the project header shows Online whenever any device in the project has reported recently (see Devices & Tokens for how that is decided).

Streaming from a tethered board

If the project has a tethered device (one that reports over USB serial or Bluetooth instead of WiFi), a Bridge button appears in the dashboard header. It opens a small panel where you connect the board — readings then stream straight into the widgets below, on the same screen. Collapsing the panel keeps the stream running (the button shows a pulsing dot while connected); navigating away stops it. See Devices & Tokens for the full tethered setup.

On phones and small screens

The canvas stacks vertically on small screens. In edit mode, the widget properties open as a bottom sheet you can scroll, so you can tweak widgets comfortably from a phone.

Next: Alerts