Dashboard Widgets

Purpose

Developer documentation for widget composition, widget configuration flow, shared widget configuration, widget inventory, and widget-specific extracted defaults and source mappings.

Widget Architecture

• Widgets are introduced through the dashboard runtime and configured through the widget configuration dialog.
• Shared widget configuration is represented by common extracted form metadata.
• Widget-specific configuration is represented by extracted widget config entries with fields, defaults, and source file references.
• This scope should cover everything a developer needs to understand that the user widget docs expose functionally.

Extracted Structure Summary

• Extracted flows: 4
• Extracted controls: 5
• Extracted dialogs: 2
• Extracted forms: 1
• Extracted tables: 1
• Extracted state groups: 1
• Extracted widget config entries: 62

Extracted Flows

• Add widget (add-widget-flow) — 3 step(s)
• Create dashboard (create-dashboard-flow) — 4 step(s)
• Save dashboard changes (save-dashboard-flow) — 2 step(s)
• Switch dashboard state (switch-dashboard-state-flow) — 2 step(s)

Extracted Dialogs

• Widget configuration (widget-config-dialog) — 2 action(s)
• Create Dashboard (dashboard-config-dialog) — 1 action(s)

Extracted Forms

• create-dashboard-form — 2 field(s)

Add Widget Flow

1. Click Add Widget.
2. The widget configuration dialog opens.
3. Save the changes.

Widget Configuration Dialog Actions

• Save
• Cancel

Mobile layout controls

Each widget config includes a Mobile app section that persists on widget config:

• config.mobile.show (boolean): mobile visibility flag.
• config.mobile.order (number | null): explicit mobile order (ascending).

Runtime behavior in web compact/mobile and native app:

1. Filter widgets where config.mobile.show === true (legacy widgets without this flag are treated as visible).
2. Sort by config.mobile.order ascending.
3. Fallback sort by desktop layout (y, then x) and widget id.

Widget Inventory

Total extracted widget config entries: 62

Alarm Summary Widget

Fields:

• Title
• Status
• Severity
• Acknowledgement State
• Limit
• Compact
• Show Severity Breakdown

Defaults:

• Title — "Alarm Summary"
• Status — ["ACTIVE"]
• Severity — ["CRITICAL", "MAJOR", "MINOR", "WARNING"]
• Acknowledgement State — "ALL"
• Limit — 200
• Compact — true
• Show Severity Breakdown — true

Source file: AlarmSummaryWidgetConfig.tsx

Alarm Widget

Fields:

• Status
• Severity
• Acknowledgement State
• Show Counters
• Auto Refresh
• Refresh Interval
• Limit
• Page Size
• Visible Columns
• Sticky Active First
• Critical Sound
• Browser Notification
• Device Filter Mode
• Device Type
• Target State ID
• Device Type Options
• State Options

Defaults:

• Status — ["ACTIVE"]
• Severity — ["CRITICAL", "MAJOR", "MINOR", "WARNING"]
• Acknowledgement State — "ALL"
• Show Counters — true
• Auto Refresh — true
• Refresh Interval — 5000
• Limit — 50
• Page Size — 10
• Visible Columns — DEFAULT_VISIBLE_COLUMNS
• Sticky Active First — true
• Critical Sound — false
• Browser Notification — false
• Device Filter Mode — "ALL"
• Device Type — ""
• Target State ID — "default"

Source file: AlarmWidgetConfig.tsx

Analog Meter Widget

Fields:

• Alias
• Devices
• Selected Device Ids
• Items
• Title
• Decimals
• Columns
• Compact
• Show Title
• Show Device Name
• Show Key
• Global Keys
• Loading Devices
• Loading Keys
• Device Ids

Defaults:

• Alias — null
• Selected Device Ids — []
• Title — "Analog Meter"
• Decimals — 1
• Columns — 2
• Compact — true
• Show Title — true
• Show Device Name — true
• Show Key — true

Source file: AnalogMeterWidgetConfig.tsx

Anomaly Insights Widget

Fields:

• Alias
• Devices
• Selected Device Ids
• Key
• Title
• Above
• Below
• Stale After MS
• Show Latest Value
• Show Last Seen
• Show Only Issues
• Loading Devices
• Loading Keys
• Device Ids

Defaults:

• Alias — null
• Selected Device Ids — []
• Key — ""
• Title — "Anomaly Insights"
• Above — null
• Below — null
• Stale After MS — null
• Show Latest Value — true
• Show Last Seen — true

Source file: AnomalyInsightsWidgetConfig.tsx

Asset Admin Table Widget

Fields:

• Title
• Asset Type
• Relation Filter
• Search Text
• Page Size
• Show Header
• Show Search
• Show Status
• Show Type
• Show Last Activity
• Show Devices Preview
• Open ON Row Click
• Next Patch

Defaults:

• Title — "Assets"
• Asset Type — ""
• Relation Filter — "all"
• Search Text — ""
• Page Size — 8
• Show Header — true
• Show Search — true
• Show Status — true
• Show Type — true
• Show Last Activity — true
• Show Devices Preview — true
• Open ON Row Click — true

Source file: AssetAdminTableWidgetConfig.tsx

Attribute Control Card Widget

Fields:

• Devices
• Attribute Keys
• Alias
• Selected Device ID

Source file: AttributeControlCardWidgetConfig.tsx

Bar Chart Widget

Fields:

• Alias
• Devices
• Selected Device Ids
• Items
• Title
• Layout
• Decimals
• Bar Size
• Show Grid
• Show Title
• Global Keys
• Loading Devices
• Loading Keys
• Device Ids
• Y Axis Min
• Next Patch
• Y Axis Max

Defaults:

• Alias — null
• Selected Device Ids — []
• Title — "Bar Chart"
• Layout — "vertical"
• Decimals — 2
• Bar Size — 28
• Show Grid — true
• Show Title — true

Source file: BarChartWidgetConfig.tsx

Battery Indicator Widget

Fields:

• Alias
• Devices
• Selected Device ID
• Title
• Show Title
• Key
• Charging Key
• Unit
• Decimals
• Value Mode
• Layout Mode
• Min Voltage
• Max Voltage
• Critical Threshold
• Low Threshold
• Medium Threshold
• Show Device Name
• Show Metric Name
• Show Timestamp
• Show Status Text
• Show Charging
• Compact
• Timestamp Mode
• Global Keys
• Loading Devices
• Loading Keys
• Device ID
• Device Ids
• Next Patch
• Metric
• Telemetry Keys

Defaults:

• Alias — null
• Selected Device ID — config.deviceIds?.[0] || "").trim(
• Title — "Battery"
• Show Title — true
• Key — "level"
• Charging Key — ""
• Unit — "%"
• Decimals — 1
• Min Voltage — 3.0
• Max Voltage — 4.2
• Critical Threshold — 15
• Low Threshold — 30
• Medium Threshold — 60
• Show Device Name — true
• Show Metric Name — true
• Show Timestamp — true
• Show Status Text — true
• Show Charging — true
• Compact — true

Source file: BatteryIndicatorWidgetConfig.tsx

Code Widget

Fields:

• Alias
• Devices
• Selected Device Ids
• Title
• Code Type
• Source Mode
• Telemetry Key
• Telemetry Keys Text
• Template
• Static Value
• QR Size
• Barcode Height
• Barcode Font Size
• Compact
• Show Header
• Show Device Name
• Show Encoded Text
• Show Key Label
• Global Keys
• Loading Devices
• Loading Keys
• Device ID
• Device Ids
• Telemetry Keys

Defaults:

• Alias — null
• Selected Device Ids — (config.deviceId ? [config.deviceId] : []
• Title — ""
• Code Type — "qr"
• Source Mode — "template"
• Telemetry Key — ""
• Template — "{deviceId}"
• Static Value — ""
• QR Size — 132) || 132, 240
• Barcode Height — 56) || 56, 120
• Barcode Font Size — 11) || 11, 20
• Compact — true
• Show Header — true
• Show Device Name — true
• Show Encoded Text — true

Source file: CodeWidgetConfig.tsx

Delta Comparison Widget

Fields:

• Alias
• Devices
• Selected Device Ids
• Key
• Title
• Aggregation
• Decimals
• Show Percent
• Good Direction
• Loading Devices
• Loading Keys
• Device Ids

Defaults:

• Alias — null
• Selected Device Ids — []
• Key — ""
• Title — "Delta Comparison"
• Aggregation — "avg"
• Decimals — 2
• Show Percent — true
• Good Direction — "neutral"

Source file: DeltaComparisonWidgetConfig.tsx

Device Alarm Widget

Fields:

• Title
• Alias
• Limit
• Status
• Severity
• Acknowledgement State
• Devices
• Selected Device Ids
• Loading Devices
• Device Ids

Defaults:

• Title — ""
• Alias — null
• Limit — 10
• Status — DEFAULT_STATUS
• Severity — DEFAULT_SEVERITY
• Acknowledgement State — "ALL"
• Selected Device Ids — []

Source file: DeviceAlarmWidgetConfig.tsx

Device Count Widget

Fields:

• Title
• Subtitle
• Status Filter
• Device Type
• Target Dashboard ID
• Target State ID
• Show Subtitle
• Show Border
• Device Types
• Loading Types
• Dashboard Options
• State Options
• Loading Dashboards
• Next Patch

Defaults:

• Title — "Devices"
• Subtitle — ""
• Status Filter — "all"
• Device Type — ""
• Target Dashboard ID — ""
• Target State ID — "default"
• Show Subtitle — true
• Show Border — true

Source file: DeviceCountWidgetConfig.tsx

Device Data Card Widget

Fields:

• Devices
• Loading Suggestions
• Telemetry Suggestions
• Attribute Suggestions
• Alias
• Selected Device ID

Source file: DeviceDataCardWidgetConfig.tsx

Device Health Widget

Fields:

• Alias
• Devices
• Selected Device Ids
• Key
• Title
• Stale After MS
• Decimals
• Show Last Seen
• Show Freshness
• Show Only Stale
• Loading Devices
• Loading Keys
• Device Ids

Defaults:

• Alias — null
• Selected Device Ids — []
• Key — ""
• Title — "Device Health"
• Stale After MS — 60000
• Decimals — 2
• Show Last Seen — true
• Show Freshness — true

Source file: DeviceHealthWidgetConfig.tsx

Device Table Widget

Fields:

• Title
• Status Filter
• Device Type
• Search Text
• Page Size
• Show Header
• Show Search
• Show Status
• Show Type
• Show Last Activity
• Open ON Row Click
• Device Types
• Loading Types
• Next Patch

Defaults:

• Title — "Devices"
• Status Filter — "all"
• Device Type — ""
• Search Text — ""
• Page Size — 8
• Show Header — true
• Show Search — true
• Show Status — true
• Show Type — true
• Show Last Activity — true
• Open ON Row Click — true

Source file: DeviceTableWidgetConfig.tsx

Digital Round Gauge Widget

Fields:

• Title
• Alias
• Devices
• Selected Device ID
• Selected Metric
• Min Value
• Max Value
• Warning Value
• Critical Value
• Decimals
• Unit
• Normal Color
• Warning Color
• Critical Color
• Show Min Max
• Show Device Name
• Show Badge
• Blink ON Critical
• Global Keys
• Loading Devices
• Loading Keys
• Device
• Metric
• Key
• Telemetry Keys
• Aggregation

Defaults:

• Title — ""
• Alias — null
• Selected Device ID — ""
• Selected Metric — config.telemetryKeys?.[0] || config.key || ""
• Min Value — config.minValue === null || config.minValue === undefined ? 0 : Number(config.minValue
• Max Value — config.maxValue === null || config.maxValue === undefined ? 100 : Number(config.maxValue
• Warning Value — config.warningValue === null || config.warningValue === undefined ? null : Number(config.warningValue
• Critical Value — config.criticalValue === null || config.criticalValue === undefined ? null : Number(config.criticalValue
• Decimals — 1) || 1
• Unit — ""
• Normal Color — "#22c55e"
• Warning Color — "#f59e0b"
• Critical Color — "#ef4444"
• Show Min Max — true
• Show Device Name — true
• Show Badge — true

Source file: DigitalRoundGaugeWidgetConfig.tsx

Digital Vertical Bar Widget

Fields:

• Title
• Alias
• Devices
• Selected Device ID
• Selected Metric
• Min Value
• Max Value
• Warning Value
• Critical Value
• Decimals
• Unit
• Normal Color
• Warning Color
• Critical Color
• Show Min Max
• Show Device Name
• Show Badge
• Blink ON Critical
• Global Keys
• Loading Devices
• Loading Keys
• Device
• Metric
• Key
• Telemetry Keys
• Aggregation

Defaults:

• Title — ""
• Alias — null
• Selected Device ID — ""
• Selected Metric — config.telemetryKeys?.[0] || config.key || ""
• Min Value — config.minValue === null || config.minValue === undefined ? 0 : Number(config.minValue
• Max Value — config.maxValue === null || config.maxValue === undefined ? 100 : Number(config.maxValue
• Warning Value — config.warningValue === null || config.warningValue === undefined ? null : Number(config.warningValue
• Critical Value — config.criticalValue === null || config.criticalValue === undefined ? null : Number(config.criticalValue
• Decimals — 1) || 1
• Unit — ""
• Normal Color — "#22c55e"
• Warning Color — "#f59e0b"
• Critical Color — "#ef4444"
• Show Min Max — true
• Show Device Name — true
• Show Badge — true

Source file: DigitalVerticalBarWidgetConfig.tsx

Doughnut Widget

Fields:

• Alias
• Devices
• Selected Device ID
• Items
• Title
• Decimals
• Inner Radius
• Outer Radius
• Show Legend
• Show Labels
• Show Title
• Show Center Total
• Center Label
• Global Keys
• Loading Devices
• Loading Keys
• Device ID
• Device Ids

Defaults:

• Alias — null
• Selected Device ID — ""
• Title — "Doughnut"
• Decimals — 2
• Inner Radius — 50
• Outer Radius — 80
• Show Legend — true
• Show Labels — true
• Show Title — true
• Show Center Total — true
• Center Label — "Total"

Source file: DoughnutWidgetConfig.tsx

Dual Axis Chart Widget

Fields:

• Alias
• Devices
• Device Ids
• Keys
• Global Keys
• Series Config

Defaults:

• Alias — null

Source file: DualAxisChartWidgetConfig.tsx

Ecg Strip Widget

Fields:

• Title
• Show Title
• Alias
• Selected Device ID
• Selected Metric
• Paper Style
• Max Samples
• Remove DC
• Gain
• Stroke Width
• Devices
• Global Keys
• Loading Devices
• Loading Keys
• Device
• Metric
• Telemetry Keys

Defaults:

• Title — ""
• Show Title — true
• Alias — null
• Selected Device ID — ""
• Selected Metric — config.telemetryKeys?.[0] || ""
• Paper Style — "monitor"
• Max Samples — 1200
• Remove DC — true
• Gain — 1
• Stroke Width — 1.6

Source file: EcgStripWidgetConfig.tsx

Gauge Widget

Fields:

• Title
• Alias
• Devices
• Selected Device ID
• Selected Metric
• Min Value
• Max Value
• Warning Value
• Critical Value
• Decimals
• Unit
• Track Color
• Normal Color
• Warning Color
• Critical Color
• Show Min Max
• Show Device Name
• Blink ON Critical
• Global Keys
• Loading Devices
• Loading Keys
• Device
• Metric
• Key
• Telemetry Keys
• Aggregation

Defaults:

• Title — ""
• Alias — null
• Selected Device ID — ""
• Selected Metric — config.telemetryKeys?.[0] || config.key || ""
• Min Value — config.minValue === null || config.minValue === undefined ? 0 : Number(config.minValue
• Max Value — config.maxValue === null || config.maxValue === undefined ? 100 : Number(config.maxValue
• Warning Value — config.warningValue === null || config.warningValue === undefined ? null : Number(config.warningValue
• Critical Value — config.criticalValue === null || config.criticalValue === undefined ? null : Number(config.criticalValue
• Decimals — 1) || 1
• Unit — ""
• Track Color — "#e5e7eb"
• Normal Color — "#22c55e"
• Warning Color — "#f59e0b"
• Critical Color — "#ef4444"
• Show Min Max — true
• Show Device Name — true

Source file: GaugeWidgetConfig.tsx

Gpio Control Widget

Fields:

• Alias
• Devices
• Selected Device Ids
• Items
• Title
• Columns
• Compact
• Confirm Before Toggle
• Retries
• Retry Interval MS
• Show Header
• Show Device Name
• Show Channel Number
• Show Raw Value
• Loading Devices
• Device ID
• Device Ids
• Math

Defaults:

• Alias — null
• Selected Device Ids — (config.deviceId ? [config.deviceId] : []
• Title — ""
• Columns — 2
• Compact — true
• Show Header — true
• Show Device Name — true
• Show Channel Number — true
• Show Raw Value — true

Source file: GpioControlWidgetConfig.tsx

Gpio Status Widget

Fields:

• Alias
• Devices
• Selected Device Ids
• Items
• Title
• Columns
• Compact
• Show Header
• Show Device Name
• Show Channel Number
• Show Value
• Show Last Update
• Loading Devices
• Device ID
• Device Ids

Defaults:

• Alias — null
• Selected Device Ids — (config.deviceId ? [config.deviceId] : []
• Title — ""
• Columns — 2
• Compact — true
• Show Header — true
• Show Device Name — true
• Show Channel Number — true
• Show Value — true

Source file: GpioStatusWidgetConfig.tsx

Image Panel Widget

Fields:

• Title
• Show Title
• Image Url
• Alt
• Object Fit
• Link Url
• Open IN New Tab

Defaults:

• Title — ""
• Show Title — true
• Image Url — ""
• Alt — ""
• Object Fit — "contain"
• Link Url — ""
• Open IN New Tab — true

Source file: ImagePanelWidgetConfig.tsx

Indoor Environment Widget

Fields:

• Alias
• Devices
• Device Ids
• Items
• Global Keys
• Title
• Columns
• Compact
• Show Title
• Show Device Name
• Show Window Label
• Show Timestamp

Defaults:

• Alias — null

Source file: IndoorEnvironmentWidgetConfig.tsx

Latest Value Card Widget

Fields:

• Alias
• Devices
• Selected Device Ids
• Selected Items
• Global Keys
• Title
• Display Mode
• Decimals
• Show Timestamp
• Timestamp Mode
• Unit Mode
• Null Text
• Grid Columns
• Loading Devices
• Loading Keys
• Device Ids
• Items
• Telemetry Keys
• Aggregation

Defaults:

• Alias — null
• Selected Device Ids — []
• Title — ""
• Display Mode — "grid"
• Decimals — 2
• Show Timestamp — true
• Timestamp Mode — "relative"
• Unit Mode — "auto"
• Null Text — "—"
• Grid Columns — 2

Source file: LatestValueCardWidgetConfig.tsx

Led Widget

Fields:

• Alias
• Devices
• Selected Device Ids
• Items
• Title
• Columns
• Compact
• Show Device Name
• Show Status Text
• Global Keys
• Loading Devices
• Loading Keys
• Device Ids

Defaults:

• Alias — null
• Selected Device Ids — []
• Title — ""
• Columns — 2
• Compact — true
• Show Status Text — true

Source file: LedWidgetConfig.tsx

Map Widget

Fields:

• Alias
• Devices
• Selected Device Ids
• Title
• Show Title
• Location Mode
• Latitude Key
• Longitude Key
• GPS Key
• State Key
• Status Key
• Heading Key
• Speed Key
• Timestamp Key
• Popup Keys
• Marker Mode
• Default Zoom
• Default Lat
• Default Lon
• Auto Fit
• Allow Zero Coordinates
• Map Style Url
• Items
• Global Keys
• Loading Devices
• Loading Keys
• Device Ids

Defaults:

• Alias — null
• Selected Device Ids — []
• Title — ""
• Show Title — true
• Location Mode — "separate"
• Latitude Key — "lat"
• Longitude Key — "lon"
• GPS Key — "gps"
• State Key — ""
• Status Key — ""
• Heading Key — ""
• Speed Key — ""
• Timestamp Key — ""
• Popup Keys — []
• Marker Mode — "asset"
• Default Zoom — 4
• Default Lat — 20.5937
• Default Lon — 78.9629
• Auto Fit — true
• Map Style Url — ""

Source file: MapWidgetConfig.tsx

Markdown Panel Widget

Fields:

• Title
• Show Title
• Content
• Font Size
• Text Align

Defaults:

• Show Title — true

Source file: MarkdownPanelWidgetConfig.tsx

Mimic Overlay Widget

Fields:

• Alias
• Devices
• Selected Device Ids
• Items
• Title
• Show Title
• Image Url
• Object Fit
• Show Labels
• Global Keys
• Loading Devices
• Loading Keys
• Device Ids
• Next Patch

Defaults:

• Alias — null
• Selected Device Ids — []
• Title — ""
• Show Title — true
• Image Url — ""
• Object Fit — config.objectFit === "fill" ? config.objectFit : "contain"
• Show Labels — true

Source file: MimicOverlayWidgetConfig.tsx

Mini Led Widget

Fields:

• Alias
• Devices
• Selected Device Ids
• Items
• Title
• Flow
• Led Size
• Gap
• Item Width
• Show Title
• Global Keys
• Loading Devices
• Loading Keys
• Device Ids

Defaults:

• Alias — null
• Selected Device Ids — []
• Title — ""
• Flow — "wrap"
• Led Size — 14
• Gap — 10
• Item Width — 56
• Show Title — true

Source file: MiniLedWidgetConfig.tsx

Mini Switch Widget

Fields:

• Alias
• Devices
• Selected Device Ids
• Items
• Title
• Flow
• Gap
• Item Width
• Show Title
• Confirm Before Toggle
• Retries
• Retry Interval MS
• Loading Devices
• Device ID
• Device Ids
• Math

Defaults:

• Alias — null
• Selected Device Ids — (config.deviceId ? [config.deviceId] : []
• Title — ""
• Flow — "wrap"
• Gap — 10
• Item Width — 72
• Show Title — true

Source file: MiniSwitchWidgetConfig.tsx

Motor Status Widget

Fields:

• Alias
• Devices
• Selected Device ID
• Status Key
• Speed Key
• Current Key
• Fault Key
• Max Rpm
• Global Keys
• Device ID
• Device Ids
• Key
• Metric
• Telemetry Keys

Defaults:

• Alias — null
• Selected Device ID — config.deviceIds?.[0] || "").trim(
• Status Key — ""
• Speed Key — ""
• Current Key — ""
• Fault Key — ""
• Max Rpm — 3000

Source file: MotorStatusWidgetConfig.tsx

Multi Device Comparison Widget

Fields:

• Title
• Alias
• Devices
• Selected Device Ids
• Selected Metric
• Min Value
• Max Value
• Warning Value
• Critical Value
• Decimals
• Unit
• Normal Color
• Warning Color
• Critical Color
• Show Title
• Show Device Name
• Show Rank
• Show Value
• Show Mini Bar
• Show Timestamp
• Compact
• Sort Order
• Max Items
• Global Keys
• Loading Devices
• Loading Keys
• Device Ids
• Metric
• Key
• Telemetry Keys
• Aggregation

Defaults:

• Title — ""
• Alias — null
• Selected Metric — config.telemetryKeys?.[0] || config.key || ""
• Min Value — 0
• Max Value — 100
• Warning Value — config.warningValue === undefined || config.warningValue === null ? null : Number(config.warningValue
• Critical Value — config.criticalValue === undefined || config.criticalValue === null ? null : Number(config.criticalValue
• Decimals — 1) || 1
• Unit — ""
• Normal Color — "#22c55e"
• Warning Color — "#f59e0b"
• Critical Color — "#ef4444"
• Show Title — true
• Show Device Name — true
• Show Rank — true
• Show Value — true
• Show Mini Bar — true
• Compact — true
• Max Items — 8

Source file: MultiDeviceComparisonWidgetConfig.tsx

Multi Gauge Widget

Fields:

• Alias
• Devices
• Selected Device Ids
• Selected Items
• Title
• Decimals
• Show Timestamp
• Timestamp Mode
• Unit Mode
• Unit Override
• Null Text
• Grid Columns
• Display Mode
• Default Min Value
• Default Max Value
• Threshold Enabled
• Threshold Direction
• Warning Threshold
• Critical Threshold
• Show Status Badge
• Global Keys
• Loading Devices
• Loading Keys
• Device Ids
• Items
• Min Value
• Max Value
• Thresholds
• Enabled
• Direction
• Warning
• Critical
• Aggregation

Defaults:

• Alias — null
• Selected Device Ids — []
• Title — ""
• Decimals — 2
• Show Timestamp — true
• Timestamp Mode — "relative"
• Unit Mode — "auto"
• Unit Override — ""
• Null Text — "—"
• Grid Columns — 2
• Default Min Value — 0
• Default Max Value — 100
• Threshold Enabled — false
• Threshold Direction — "above"
• Show Status Badge — true

Source file: MultiGaugeWidgetConfig.tsx

Multi Timeseries Widget

Fields:

• Alias
• Devices
• Device Ids
• Keys
• Global Keys
• Series Config

Defaults:

• Alias — null

Source file: MultiTimeseriesWidgetConfig.tsx

Navigation Button Widget

Fields:

• Title
• Label
• Target Type
• Target State ID
• Target Dashboard ID
• Url
• Variant
• Open IN New Tab
• Require Selected Entity
• Show Title
• Next Patch
• Alias
• Device ID
• Device Ids
• Key
• Metric
• Telemetry Keys
• Show Device Name

Defaults:

• Title — "Navigation Button"
• Label — "Navigate"
• Target Type — "dashboardState"
• Target State ID — "default"
• Target Dashboard ID — ""
• Url — ""
• Variant — "primary"
• Show Title — true

Source file: NavigationButtonWidgetConfig.tsx

Neon Round Gauge Widget

Fields:

• Title
• Alias
• Devices
• Selected Device ID
• Selected Metric
• Min Value
• Max Value
• Warning Value
• Critical Value
• Decimals
• Unit
• Normal Color
• Warning Color
• Critical Color
• Show Min Max
• Show Device Name
• Show Badge
• Blink ON Critical
• Global Keys
• Loading Devices
• Loading Keys
• Device
• Metric
• Key
• Telemetry Keys
• Aggregation

Defaults:

• Title — ""
• Alias — null
• Selected Device ID — ""
• Selected Metric — config.telemetryKeys?.[0] || config.key || ""
• Min Value — config.minValue === null || config.minValue === undefined ? 0 : Number(config.minValue
• Max Value — config.maxValue === null || config.maxValue === undefined ? 100 : Number(config.maxValue
• Warning Value — config.warningValue === null || config.warningValue === undefined ? null : Number(config.warningValue
• Critical Value — config.criticalValue === null || config.criticalValue === undefined ? null : Number(config.criticalValue
• Decimals — 1) || 1
• Unit — ""
• Normal Color — "#46ffb2"
• Warning Color — "#ffd84d"
• Critical Color — "#ff4d6d"
• Show Min Max — true
• Show Device Name — true
• Show Badge — true

Source file: NeonRoundGaugeWidgetConfig.tsx

Neon Vertical Bar Widget

Fields:

• Title
• Alias
• Devices
• Selected Device ID
• Selected Metric
• Min Value
• Max Value
• Warning Value
• Critical Value
• Decimals
• Unit
• Normal Color
• Warning Color
• Critical Color
• Show Min Max
• Show Device Name
• Show Badge
• Blink ON Critical
• Global Keys
• Loading Devices
• Loading Keys
• Device
• Metric
• Key
• Telemetry Keys
• Aggregation

Defaults:

• Title — ""
• Alias — null
• Selected Device ID — ""
• Selected Metric — config.telemetryKeys?.[0] || config.key || ""
• Min Value — config.minValue === null || config.minValue === undefined ? 0 : Number(config.minValue
• Max Value — config.maxValue === null || config.maxValue === undefined ? 100 : Number(config.maxValue
• Warning Value — config.warningValue === null || config.warningValue === undefined ? null : Number(config.warningValue
• Critical Value — config.criticalValue === null || config.criticalValue === undefined ? null : Number(config.criticalValue
• Decimals — 1) || 1
• Unit — ""
• Normal Color — "#46ffb2"
• Warning Color — "#ffd84d"
• Critical Color — "#ff4d6d"
• Show Min Max — true
• Show Device Name — true
• Show Badge — true

Source file: NeonVerticalBarWidgetConfig.tsx

Pie Chart Widget

Fields:

• Alias
• Devices
• Selected Device Ids
• Items
• Title
• Decimals
• Inner Radius
• Outer Radius
• Show Legend
• Show Labels
• Show Title
• Global Keys
• Loading Devices
• Loading Keys
• Device Ids

Defaults:

• Alias — null
• Selected Device Ids — []
• Title — "Pie Chart"
• Decimals — 2
• Inner Radius — 0
• Outer Radius — 80
• Show Legend — true
• Show Labels — true
• Show Title — true

Source file: PieChartWidgetConfig.tsx

Process Instrument Widget

Fields:

• Alias
• Devices
• Selected Device ID
• Title
• Show Title
• Key
• Unit
• Decimals
• Instrument Type
• Min Value
• Max Value
• Warning Value
• Critical Value
• Show Device Name
• Show Metric Name
• Show Timestamp
• Timestamp Mode
• Compact
• Global Keys
• Loading Devices
• Loading Keys
• Device ID
• Device Ids
• Next Patch
• Metric
• Telemetry Keys

Defaults:

• Alias — null
• Selected Device ID — config.deviceIds?.[0] || "").trim(
• Title — "Process Instrument"
• Show Title — true
• Key — "level"
• Unit — ""
• Decimals — 1
• Min Value — 0
• Max Value — 100
• Warning Value — ""
• Critical Value — ""
• Show Device Name — true
• Show Metric Name — true
• Show Timestamp — true
• Compact — true

Source file: ProcessInstrumentWidgetConfig.tsx

Progress Bar Widget

Fields:

• Alias
• Devices
• Selected Device Ids
• Title
• Telemetry Key
• Min Value
• Max Value
• Decimals
• Suffix
• Stroke Height
• Status Mode
• Compact
• Show Header
• Show Device Name
• Show Value
• Show Min Max
• Show Percent
• Global Keys
• Loading Devices
• Loading Keys
• Device ID
• Device Ids
• Metric
• Key
• Telemetry Keys

Defaults:

• Alias — null
• Selected Device Ids — (config.deviceId ? [config.deviceId] : []
• Title — ""
• Telemetry Key — config.metric || config.key || config.telemetryKeys?.[0] || ""
• Suffix — ""
• Status Mode — "normal"
• Compact — true
• Show Header — true
• Show Device Name — true
• Show Value — true
• Show Min Max — true
• Show Percent — true

Source file: ProgressBarWidgetConfig.tsx

Pump Status Widget

Fields:

• Alias
• Devices
• Selected Device ID
• Title
• Show Title
• Key
• Flow Key
• Pressure Key
• Fault Key
• Flow Unit
• Pressure Unit
• Show Device Name
• Show Timestamp
• Global Keys
• Loading Devices
• Loading Keys
• Device ID
• Device Ids
• IS Dashboard State Alias
• Next Patch
• Metric
• Telemetry Keys

Defaults:

• Alias — null
• Selected Device ID — config.deviceIds?.[0] || "").trim(
• Title — "Pump Status"
• Show Title — true
• Key — "status"
• Flow Key — "flow"
• Pressure Key — "pressure"
• Fault Key — "fault"
• Flow Unit — "L/min"
• Pressure Unit — "bar"
• Show Device Name — true
• Show Timestamp — true

Source file: PumpStatusWidgetConfig.tsx

Radar Telemetry Widget

Fields:

• Title
• Show Title
• Alias
• Selected Device ID
• Selected Keys
• Radar Max
• Devices
• Loading Devices
• Global Keys
• Loading Keys
• Device
• Metric
• Telemetry Keys
• Keys

Defaults:

• Title — ""
• Show Title — true
• Alias — null
• Selected Device ID — ""
• Radar Max — config.radarMax === undefined || config.radarMax === null ? null : Number(config.radarMax

Source file: RadarTelemetryWidgetConfig.tsx

Range Chart Widget

Fields:

• Title
• Alias
• Devices
• Selected Device ID
• Selected Metric
• Threshold Mode
• Normal Threshold
• Warning Threshold
• Critical Threshold
• Line Width
• Line Color
• Normal Color
• Warning Color
• Critical Color
• Curve Type
• Show Points
• Show Threshold Lines
• Summary Metrics
• Y Axis Min
• Y Axis Max
• Global Keys
• Loading Devices
• Loading Keys

Defaults:

• Title — ""
• Alias — null
• Selected Device ID — ""
• Selected Metric — config.telemetryKeys?.[0] || ""
• Threshold Mode — "").trim().toLowerCase() === "descending" ? "descending" : "ascending"
• Normal Threshold — config.normalThreshold === null || config.normalThreshold === undefined ? null : Number(config.normalThreshold
• Warning Threshold — config.warningThreshold === null || config.warningThreshold === undefined ? null : Number(config.warningThreshold
• Critical Threshold — config.criticalThreshold === null || config.criticalThreshold === undefined ? null : Number(config.criticalThreshold
• Line Width — 2) || 2, 8
• Line Color — "#1677ff"
• Normal Color — "#22c55e"
• Warning Color — "#f59e0b"
• Critical Color — "#ef4444"
• Curve Type — "monotone") as CurveType
• Show Threshold Lines — true
• Y Axis Min — config.yAxisMin === null || config.yAxisMin === undefined ? null : Number(config.yAxisMin
• Y Axis Max — config.yAxisMax === null || config.yAxisMax === undefined ? null : Number(config.yAxisMax

Source file: RangeChartWidgetConfig.tsx

Route Map Widget

Fields:

• Alias
• Devices
• Selected Device ID
• Title
• Show Title
• Location Mode
• Latitude Key
• Longitude Key
• GPS Key
• Heading Key
• Speed Key
• Timestamp Key
• Default Zoom
• Default Lat
• Default Lon
• Auto Fit
• Show Start Marker
• Show End Marker
• Show Live Marker
• Allow Zero Coordinates
• Max Points
• Route Color
• Route Opacity
• Line Width
• Map Style Url
• Loading Devices
• Loading Keys
• Global Keys
• Device ID
• Device Ids
• Telemetry Keys
• Metric

Defaults:

• Alias — null
• Selected Device ID — config.deviceIds?.[0] || "").trim(
• Title — "Route Map"
• Show Title — true
• Latitude Key — "lat"
• Longitude Key — "lon"
• GPS Key — "gps"
• Heading Key — ""
• Speed Key — ""
• Timestamp Key — ""
• Default Zoom — 4
• Default Lat — 20.5937
• Default Lon — 78.9629
• Auto Fit — true
• Show Start Marker — true
• Show End Marker — true
• Show Live Marker — true
• Max Points — 1500
• Route Color — "#2563eb"
• Route Opacity — 0.9
• Line Width — 4
• Map Style Url — ""

Source file: RouteMapWidgetConfig.tsx

RPC Widget

Fields:

• Alias
• Devices
• Selected Device Ids
• Title
• Actions
• Columns
• Compact
• Show Execution Log
• Max Log Entries
• Retries
• Retry Interval MS
• Loading Devices
• Active Action Tab
• Device ID
• Device Ids
• Patch

Defaults:

• Alias — null
• Selected Device Ids — (config.deviceId ? [config.deviceId] : []
• Title — ""
• Columns — 1
• Show Execution Log — true
• Active Action Tab — ""

Source file: RPCWidgetConfig.tsx

Scatter Telemetry Widget

Fields:

• Title
• Alias
• Selected Device ID
• X Key
• Y Key
• Devices
• Global Keys
• Loading Devices
• Loading Keys
• Device
• Metric
• Telemetry Keys
• Keys

Defaults:

• Title — ""
• Alias — null
• Selected Device ID — ""
• X Key — config.keys?.[0] || config.metric || ""
• Y Key — config.keys?.[1] || ""

Source file: ScatterTelemetryWidgetConfig.tsx

Signal Strength Widget

Fields:

• Alias
• Devices
• Selected Device ID
• Title
• Show Title
• Key
• Secondary Key
• Unit
• Secondary Unit
• Decimals
• Secondary Decimals
• Value Mode
• Display Mode
• Min Rssi
• Max Rssi
• Critical Threshold
• Low Threshold
• Medium Threshold
• Show Device Name
• Show Metric Name
• Show Timestamp
• Show Status Text
• Show Secondary
• Compact
• Timestamp Mode
• Global Keys
• Loading Devices
• Loading Keys
• Device ID
• Device Ids
• Next Patch
• Metric
• Telemetry Keys

Defaults:

• Alias — null
• Selected Device ID — config.deviceIds?.[0] || "").trim(
• Title — "Signal Strength"
• Show Title — true
• Key — "level"
• Secondary Key — ""
• Unit — "%"
• Secondary Unit — ""
• Decimals — 1
• Secondary Decimals — 1
• Min Rssi — -110
• Max Rssi — -50
• Critical Threshold — 15
• Low Threshold — 30
• Medium Threshold — 60
• Show Device Name — true
• Show Metric Name — true
• Show Timestamp — true
• Show Status Text — true
• Show Secondary — true
• Compact — true

Source file: SignalStrengthWidgetConfig.tsx

Slider Control Widget

Fields:

• Alias
• Devices
• Selected Device Ids
• Title
• Key
• Key Options
• Global Keys
• Minimum
• Maximum
• Step
• Unit
• Decimals
• Show Value
• Show Device Name
• Compact
• Send Mode
• Retries
• Retry Interval MS
• Loading Devices
• Loading Keys
• Device ID
• Device Ids
• Metric
• Telemetry Keys
• Math

Defaults:

• Alias — null
• Selected Device Ids — (config.deviceId ? [config.deviceId] : []
• Title — ""
• Key — ""
• Unit — ""
• Show Value — true
• Show Device Name — true

Source file: SliderControlWidgetConfig.tsx

State Timeline Widget

Fields:

• Alias
• Devices
• Selected Device Ids
• Selected Items
• Title
• Row Height
• Show Current State
• Global Keys
• Loading Devices
• Loading Keys
• Device Ids
• Items
• Aggregation

Defaults:

• Alias — null
• Selected Device Ids — []
• Title — ""
• Row Height — 22
• Show Current State — true

Source file: StateTimelineWidgetConfig.tsx

Status Matrix Widget

Fields:

• Alias
• Devices
• Device Ids
• Title
• Keys
• Key Options
• Columns
• Compact
• Show Title
• Show Device Name
• Show Key Label
• Show Timestamp
• Stale After MS
• Loading Devices
• Loading Keys
• Device ID
• Telemetry Keys
• Key
• Metric

Defaults:

• Alias — null
• Title — ""
• Compact — true
• Show Title — true
• Show Device Name — true
• Show Key Label — true
• Show Timestamp — true

Source file: StatusMatrixWidgetConfig.tsx

Status Panel Widget

Fields:

• Alias
• Devices
• Selected Device ID
• Items
• Title
• Show Title
• Show Device Name
• Show Timestamp
• Timestamp Mode
• Decimals
• Null Text
• Compact
• Global Keys
• Loading Devices
• Loading Keys
• Device ID
• Device Ids
• Telemetry Keys
• Metric
• Next Patch

Defaults:

• Alias — null
• Selected Device ID — config.deviceIds?.[0] || "").trim(
• Title — "Status Panel"
• Show Title — true
• Show Device Name — true
• Show Timestamp — true
• Decimals — 1
• Null Text — "—"
• Compact — true

Source file: StatusPanelWidgetConfig.tsx

Switch Widget

Fields:

• Alias
• Devices
• Selected Device Ids
• Items
• Title
• Columns
• Compact
• Confirm Before Toggle
• Retries
• Retry Interval MS
• Loading Devices
• Device ID
• Device Ids
• Math

Defaults:

• Alias — null
• Selected Device Ids — (config.deviceId ? [config.deviceId] : []
• Title — ""
• Columns — 1

Source file: SwitchWidgetConfig.tsx

Tank Level Widget

Fields:

• Alias
• Devices
• Selected Device ID
• Title
• Show Title
• Key
• Unit
• Decimals
• Value Mode
• Min Value
• Max Value
• Low Low
• Low
• High
• High High
• Show Thresholds
• Show Scale
• Show Value
• Show Min Max
• Show Device Name
• Show Metric Name
• Show Timestamp
• Timestamp Mode
• Color Mode
• Fill Color
• Animate Fill
• Tank Shape
• Global Keys
• Loading Devices
• Loading Keys
• Device ID
• Device Ids
• Next Patch
• Metric
• Telemetry Keys

Defaults:

• Alias — null
• Selected Device ID — config.deviceIds?.[0] || "").trim(
• Title — "Tank Level"
• Show Title — true
• Key — "level"
• Unit — "%"
• Decimals — 1
• Min Value — 0
• Max Value — 100
• Low Low — 10
• Low — 25
• High — 75
• High High — 90
• Show Thresholds — true
• Show Scale — true
• Show Value — true
• Show Min Max — true
• Show Device Name — true
• Show Metric Name — true
• Show Timestamp — true
• Fill Color — "#2563eb"

Source file: TankLevelWidgetConfig.tsx

Threshold Breach Widget

Fields:

• Alias
• Devices
• Selected Device Ids
• Key
• Title
• Above
• Below
• Min Duration MS
• Show Times
• Show Latest Value
• Show Only Active
• Global Keys
• Loading Devices
• Loading Keys
• Device Ids

Defaults:

• Alias — null
• Selected Device Ids — []
• Key — ""
• Title — "Threshold Breach"
• Above — null
• Below — null
• Min Duration MS — 0
• Show Times — true
• Show Latest Value — true

Source file: ThresholdBreachWidgetConfig.tsx

Timeseries Table Widget

Fields:

• Title
• Alias
• Devices
• Selected Device ID
• Selected Metric
• Page Size
• Decimals
• Null Text
• Timestamp Format
• Sort Order
• Show Header
• Show Search
• Show Timestamp
• Show Index
• Show Latest Badge
• Dense
• Bordered
• Summary Metrics
• Y Axis Min
• Y Axis Max
• Global Keys
• Loading Devices
• Loading Keys
• Device
• Metric
• Key
• Telemetry Keys
• Aggregation

Defaults:

• Title — "Timeseries Table"
• Alias — null
• Selected Device ID — ""
• Selected Metric — config.telemetryKeys?.[0] || ""
• Page Size — 10) || 10, 100
• Decimals — 2) || 2, 8
• Null Text — "—"
• Timestamp Format — "datetime") as TimestampFormat
• Sort Order — "desc").toLowerCase() === "asc" ? "asc" : "desc") as "asc" | "desc"
• Show Header — true
• Show Search — true
• Show Timestamp — true
• Show Latest Badge — true
• Bordered — true
• Y Axis Min — config.yAxisMin === null || config.yAxisMin === undefined ? null : Number(config.yAxisMin
• Y Axis Max — config.yAxisMax === null || config.yAxisMax === undefined ? null : Number(config.yAxisMax

Source file: TimeseriesTableWidgetConfig.tsx

Timeseries Widget

Fields:

• Title
• Alias
• Devices
• Selected Device ID
• Selected Metric
• Line Width
• Line Color
• Curve Type
• Show Points
• Summary Metrics
• Y Axis Min
• Y Axis Max
• Global Keys
• Loading Devices
• Loading Keys
• Device
• Metric
• Telemetry Keys
• Color
• Aggregation

Defaults:

• Title — ""
• Alias — null
• Selected Device ID — ""
• Selected Metric — config.telemetryKeys?.[0] || ""
• Line Width — 2) || 2, 8
• Line Color — "#1677ff"
• Curve Type — "monotone") as CurveType
• Y Axis Min — config.yAxisMin === null || config.yAxisMin === undefined ? null : Number(config.yAxisMin
• Y Axis Max — config.yAxisMax === null || config.yAxisMax === undefined ? null : Number(config.yAxisMax

Source file: TimeseriesWidgetConfig.tsx

Toggle Button Widget

Fields:

• Alias
• Devices
• Selected Device Ids
• Title
• Control Mode
• Channel
• Key
• ON Label
• Off Label
• ON Value Text
• Off Value Text
• Compact
• Confirm Before Toggle
• Show Device Name
• Full Width
• Danger When Off
• Active Button Type
• Retries
• Retry Interval MS
• Loading Devices
• Loading Keys
• Global Keys
• Device ID
• Device Ids
• Telemetry Key
• Metric
• Telemetry Keys
• Next Control Mode
• ON Value
• Off Value
• Math

Defaults:

• Alias — null
• Selected Device Ids — (config.deviceId ? [config.deviceId] : []
• Title — ""
• Channel — 1) || 1
• Key — config.telemetryKey || config.metric || ""
• ON Label — "ON"
• Off Label — "OFF"
• ON Value Text — 1
• Off Value Text — 0
• Show Device Name — true
• Full Width — true
• Retries — 0) || 0, 10
• Retry Interval MS — 1000) || 1000, 60000

Source file: ToggleButtonWidgetConfig.tsx

Top N Widget

Fields:

• Title
• Alias
• Devices
• Selected Device Ids
• Selected Metric
• Min Value
• Max Value
• Warning Value
• Critical Value
• Decimals
• Unit
• Normal Color
• Warning Color
• Critical Color
• Show Title
• Show Rank
• Show Device Name
• Show Value
• Show Bar
• Show Timestamp
• Compact
• Mode
• Item Count
• Global Keys
• Loading Devices
• Loading Keys
• Device Ids
• Metric
• Key
• Telemetry Keys
• Aggregation

Defaults:

• Title — ""
• Alias — null
• Selected Metric — config.telemetryKeys?.[0] || config.key || ""
• Min Value — 0
• Max Value — 100
• Warning Value — config.warningValue === undefined || config.warningValue === null ? null : Number(config.warningValue
• Critical Value — config.criticalValue === undefined || config.criticalValue === null ? null : Number(config.criticalValue
• Decimals — 1
• Unit — ""
• Normal Color — "#22c55e"
• Warning Color — "#f59e0b"
• Critical Color — "#ef4444"
• Show Title — true
• Show Rank — true
• Show Device Name — true
• Show Value — true
• Show Bar — true
• Compact — true
• Item Count — 5

Source file: TopNWidgetConfig.tsx

Trend Direction Widget

Fields:

• Alias
• Devices
• Selected Device Ids
• Key
• Title
• Decimals
• Show First Last
• Show Delta
• Show Percent
• Good Direction
• Loading Devices
• Loading Keys
• Device Ids

Defaults:

• Alias — null
• Selected Device Ids — []
• Key — ""
• Title — "Trend Direction"
• Decimals — 2
• Show First Last — true
• Show Delta — true
• Show Percent — true
• Good Direction — "neutral"

Source file: TrendDirectionWidgetConfig.tsx

Valve Position Widget

Fields:

• Alias
• Devices
• Selected Device ID
• Title
• Show Title
• Key
• Unit
• Open Threshold
• Closed Threshold
• Show Device Name
• Show Timestamp
• Show Animation
• Global Keys
• Loading Devices
• Loading Keys
• Device ID
• Device Ids
• Next Patch
• Metric
• Telemetry Keys

Defaults:

• Alias — null
• Selected Device ID — config.deviceIds?.[0] || "").trim(
• Title — "Valve Position"
• Show Title — true
• Key — "position"
• Unit — "%"
• Open Threshold — 80
• Closed Threshold — 20
• Show Device Name — true
• Show Timestamp — true
• Show Animation — true

Source file: ValvePositionWidgetConfig.tsx

Developer Notes

• This scope mirrors the user add-widget and widget-configuration coverage, but exposes structure and source mapping needed by developers.
• Runtime telemetry resolution belongs in the dashboard realtime scope.