Board Şablonu

Dört adede kadar etiketli karoyu yan yana gösteren kompakt bir pano. Her karo bir değer, isteğe bağlı bir birim, bir simge, bir renk, bir trend oku ve kendi dokunma hedefini taşır — birbiriyle ilişkili birkaç metriği bir bakışta öne çıkarmak için idealdir.

Fields

Field	Type	Description
`template`	string	Required. Must be `"board"`
`tiles`	array	Required. 1–4 tile objects (see below). Sending more than four is rejected with a validation error
`state`	string	Status text shown beside the activity `name` (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: `teal`
`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

ℹ Bilgi

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 — a label, value, or unit longer than the limits above is rejected with a validation error.

Example: Service Status Board

Hizmet durumu panosu

{
  "state": "ongoing",
  "content": {
    "template": "board",
    "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