Status Light

A compact indicator that displays state as a colored dot or badge. The color changes based on synced state values mapped through statusColors.

Type

"statusLight"

Relevant Fields

Inherits all Control Definition. Key fields:

Field Type Default Description
label string falls back to id Text beside the indicator
tint color "#34C759" Default indicator color
statusColors object — Map state strings to hex colors
size string "default" "small" (8pt), "default" (12pt), "large" (18pt)
style string "dot" "dot" (circle) or "badge" (pill with state text)
pulse bool false Pulse animation when active
defaultValue string — Initial state key

Examples

Server status indicator

{
  "type": "statusLight",
  "id": "server-status",
  "position": [0, 0],
  "label": "API Server",
  "statusColors": {
    "online": "#34C759",
    "degraded": "#FF9500",
    "offline": "#FF3B30"
  },
  "size": "large",
  "style": "badge",
  "pulse": true,
  "defaultValue": "offline",
  "sync": { "method": "meshsocket", "event": "server_health" }
}