Building Boards
The Board Editor is a no-code tool for designing dashboards that display your app’s data in real time.
Opening the Board Editor
- Open your app in the cloud IDE.
- Click the Board button in the side menu.
- The Board Editor opens, showing your current dashboard layout.
Adding Widgets
Click Add Widget to place a new component on the board. Available widget types:
| Widget | Use Case |
|---|---|
| Line Chart | Time-series trends (temperature over time) |
| Bar Chart | Categorical comparisons |
| Pie Chart | Distribution / proportions |
| Gauge | Real-time single values (speed, pressure) |
| Value Display | Show a single number or text |
| Table | Tabular data with sorting/filtering |
| Map | Device locations with data overlays |
| Embed | External web content or device remote access tunnels |
Connecting Data
Each widget is connected to a table and column from your data-template.yml:
- Select the widget.
- Choose the data source table.
- Map columns to the widget’s axes or fields.
- Set any filters or aggregation options.
Data updates in real time — as new data arrives from devices, widgets refresh automatically.
Layout
Drag and resize widgets to arrange your dashboard. The board supports:
- Grid-based positioning
- Responsive layout that works on different screen sizes
- Multiple pages / tabs within a single board
The board-template.yml File
The Board Editor generates a board-template.yml file in your .ironflock/ directory. This file describes the complete board layout, widget configuration, and data mappings.
You can also edit this file manually if you prefer.
It’s perfectly fine for an app to only collect data without providing a board. Data logger apps commonly let users build their own dashboards from the collected data. User-created dashboards can even combine data from multiple apps.
Embed Widget
The Embed widget is particularly powerful — you can embed a device’s remote access tunnel directly in the board. This creates a seamless experience where users can monitor global data and interact with individual devices from the same interface.