Widget Reference
IronFlock boards are built from widgets. Each widget type serves a specific purpose — from displaying live data to capturing user input. Add any widget by dragging it from the widget panel onto your board canvas, then configure it through the settings panel.
Cartesian Chart
Displays time-series or categorical data as line charts, bar charts, or a combination. Supports multiple data series on the same chart.
When to use: Trending sensor values over time, comparing multiple signals side by side, showing daily totals as bars.
What you configure:
- One or more data series, each pointing to a data column from your app
- Chart type per series: line, bar, or bubble
- X-axis type: time-based or categorical
- Y-axis label and time window (e.g. last 5 minutes aggregated by minute)
- Colors per series
Gauge
A radial gauge showing a single live value with colored threshold zones.
When to use: Temperature, pressure, fill level, or any value where you want at-a-glance status with green/yellow/red zones.
What you configure:
- The data column to read (always shows the most recent value)
- Unit and decimal precision
- Color zone boundaries (e.g. safe: 0–60, warning: 60–80, critical: 80–120)
- Optional: average the last N readings to smooth out noise
Value Display
Shows one or more single values with labels and units. Clean and minimal — great for KPI tiles.
When to use: Showing current temperature, uptime, last event, or any key metric as a number.
What you configure:
- One or more data columns, each with a label and unit
- Decimal precision
- Text colors per value
Doughnut Chart
A circular chart showing proportional segments.
When to use: Showing distribution — e.g. devices online vs offline, share of production by product type.
What you configure:
- Segments, each with a label, color, and data column (or fixed value)
- Cutout size (controls inner hole diameter)
Table
Displays rows of data in a tabular format with configurable columns.
When to use: Showing a list of machines, recent events, inspection records, or any structured dataset.
What you configure:
- Columns, each with a header, data column, and display type
- Row height and header font size
- Number of rows to display
Column display types: plain text, number, state (maps values to colors), boolean, image, or button (clickable link).
Map
Displays geographic data on an interactive map. Supports circle markers and tracking lines.
When to use: Showing device locations, vehicle tracking, field asset positions.
What you configure:
- Map style (light or dark)
- One or more series: circles (latest position markers) or lines (movement tracks)
- The data columns for latitude and longitude
- A pivot column to split data by device or asset
Heatmap
A grid-based heatmap for visualizing intensity across two dimensions.
When to use: Energy consumption by hour and day of week, machine utilization per shift, anomaly patterns across time.
What you configure:
- X-axis (e.g. hour of day) and Y-axis (e.g. day of week) columns
- The value column for heat intensity
- Min/max scale and whether to use a continuous or stepped color gradient
State History
A horizontal timeline showing when states changed over time, one row per asset.
When to use: Machine status history (running / stopped / maintenance), shift logs, event timelines.
What you configure:
- State names and their colors (e.g. Running = green, Failure = red)
- The data columns for timestamp, state value, and asset name
Image Overlay
Places live data values on top of a background image — great for floor plans, diagrams, or schematics.
When to use: Overlaying temperatures onto a factory floor plan, showing fill levels on a tank diagram.
What you configure:
- Background image URL
- Overlay pins: progress bars or text labels positioned at relative coordinates on the image
- Data column for each pin (live value or fixed)
Image
Displays a static image from a URL. Useful for logos, diagrams, or instructional graphics.
Text Box
A simple card showing title, subtitle, and body text. Useful for section headings, instructions, or labels on a board page.