Board Template

A compact dashboard that shows up to four labeled tiles side by side. Each tile carries a value, optional unit, icon, color, trend arrow, and its own tap target — ideal for surfacing several related metrics at a glance.

Fields

Field	Type	Description
`template`	string	Required. Must be `"board"`
`tiles`	array	Required. 1–4 tile objects (see below). More than four are dropped to fit the layout
`title`	string	Board heading shown above the tiles
`state`	string	Status text shown beside the title (e.g. "All systems nominal")
`icon`	string	SF Symbol name (e.g. `"server.rack"`) or MDI icon with `mdi:` prefix
`accent_color`	string	Named color or hex used for the heading icon and tile values. Default: `blue`
`background_color`	string	Background color override
`text_color`	string	Text color override

Tile object

Each entry in tiles is an object:

Field	Type	Description
`label`	string	Required. Tile caption. Max 32 characters
`value`	string	Required. Primary value. Max 16 characters
`unit`	string	Unit suffix shown after the value (e.g. "%", "GB"). Max 8 characters
`icon`	string	SF Symbol or MDI icon shown beside the label
`color`	string	Named color or hex for this tile's value. Falls back to `accent_color`
`trend`	string	One of `up`, `down`, `flat` — renders a trend arrow
`url_action`	object	Per-tile tap target. Same shape as tap actions

ℹ Info

Send 1 to 4 tiles. The board fits inside the same ~4 KB APNs payload as every other template, so keep labels and values short — long strings are truncated to the limits above.

Example: Service Status Board

Service status board

{
  "state": "ongoing",
  "content": {
    "template": "board",
    "title": "Homelab",
    "state": "All systems nominal",
    "icon": "server.rack",
    "accent_color": "green",
    "tiles": [
      { "label": "Uptime", "value": "99.98", "unit": "%", "icon": "checkmark.circle", "color": "green", "trend": "flat" },
      { "label": "CPU", "value": "47", "unit": "%", "icon": "cpu", "color": "cyan", "trend": "up" },
      { "label": "Memory", "value": "6.2", "unit": "GB", "color": "blue" },
      {
        "label": "Errors",
        "value": "3",
        "unit": "/h",
        "icon": "exclamationmark.triangle",
        "color": "orange",
        "trend": "down",
        "url_action": { "url": "https://grafana.example.com/errors", "foreground": true }
      }
    ]
  }
}

Typical Flow

Start the board (ended -> ongoing): Send the initial set of tiles
Update tiles (ongoing -> ongoing): Re-send the tiles array with new values — the board redraws in place
Finish (ongoing -> ended): Optionally send a final snapshot, then end the activity

Buttons & tap targets

Each tile can carry its own url_action, so a single board can deep-link to several destinations — one per metric. See Tap actions for the action object shape.

Use Cases

Infrastructure — uptime, CPU, memory, and error-rate at a glance
Smart home — room temperatures, energy use, device states
Media servers — active streams, queue depth, transcodes, library size
Sports & finance — scoreboards, portfolio tickers, KPI dashboards