a
aREST
Dashboards

Widgets

Visualize data and control devices with customizable widgets.

Adding a Widget

To add a widget to your dashboard:

  1. Open your dashboard in edit mode
  2. Click Add Widget
  3. Choose a widget type from the list
  4. Select the device and data to display
  5. Configure the widget settings
  6. Click Add

Widget Types

Chart

Visualization

Display historical data as line, bar, or area charts. Great for tracking trends and comparing values over time.

Options: chart type, time range, multiple variables, colors

42

Metric

Value Display

Show a single value with optional trend indicator. Perfect for displaying current temperature, humidity, or other readings.

Options: label, units, thresholds, trend arrows, colors

Gauge

Visualization

Circular gauge showing a value within a range. Ideal for showing capacity, levels, or percentage values.

Options: min/max values, color zones, percentage display

Control

Interactive

Interactive controls for device pins and functions. Add toggle switches for digital pins, sliders for PWM, or buttons for functions.

Options: switch, slider, button, labels, pin selection

Status

Indicator

Show device or sensor status with color-coded indicators. Great for online/offline status or alert states.

Options: online/offline states, custom colors, icons, labels

Configuring Widgets

Each widget has settings you can customize:

Data Source

Select which device and variable/pin the widget displays or controls.

Title & Label

Set a custom title that appears above the widget.

Units

Add units like "°C", "%", "lux" to make values meaningful.

Thresholds

Set warning and critical thresholds to color-code values.

Resizing & Positioning

In edit mode, you can arrange widgets on a 12-column grid:

  • Drag - Click and hold a widget to move it
  • Resize - Use the handle in the bottom-right corner
  • Snap to grid - Widgets align automatically

Tip: Make chart widgets wider for better readability. Metric and status widgets work well in smaller sizes.

Widget Examples

Temperature Monitor

Use a Metric widget to show current temperature with color thresholds:

  • Green below 25°C (comfortable)
  • Yellow at 25-30°C (warm)
  • Red above 30°C (hot)

Light Control

Use a Control widget with switch type:

  • Select digital pin connected to your relay
  • Label as "Living Room Light"
  • Toggle on/off from the dashboard

Humidity Trend

Use a Chart widget to show humidity over time:

  • Line chart type
  • 24-hour time range
  • Shows patterns throughout the day

Best Practices

Group related widgets

Place related metrics together. All temperature sensors in one area, controls in another.

Use meaningful titles

"Living Room Temperature" is clearer than just "Temperature" when you have multiple sensors.

Set thresholds for important metrics

Color-code values to quickly identify normal vs. warning vs. critical states at a glance.

Don't overcrowd

Leave some space between widgets. Create multiple dashboards for different purposes.