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: 54

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

Widget Inventory

Total extracted widget config entries: 54

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

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

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

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

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

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.