Timeline टेम्पलेट

कालांतराने मूल्ये ट्रॅक करण्यासाठी एक रिअल-टाइम स्पार्कलाइन चार्ट. प्रत्येक पुश एक डेटा पॉइंट पाठवतो; सर्व्हर इतिहास साठवतो आणि पुश सूचनांद्वारे iOS ला स्पार्कलाइन डेटा पोहोचवतो.

Fields

Field	Type	Description
`template`	string	Required. Must be `"timeline"`
`value`	object	The data point(s) for this push. Required. A labeled map (e.g. `{\"CPU\": 72.5}` or `{\"CPU\": 72.5, \"GPU\": 45.2}`). Max 10 series, 32-char keys
`unit`	string	Unit suffix on value display (e.g. "°C", "%"). Max 32 characters. Used as fallback when `units` is set
`units`	object	Per-series unit overrides. Keys must match `value` keys; missing keys fall back to `unit`. Max 32-char values
`scale`	string	Y-axis scaling: `"linear"` (default) or `"logarithmic"`
`decimals`	integer	Decimal places for display. `null` = auto-detect. Range 0–10
`smoothing`	boolean	Curve interpolation between points. Default: `false` (straight segments)
`thresholds`	array	Up to 5 horizontal reference lines. Each has `value` (required), `color`, and `label` (max 12 chars)
`state`	string	Status text (e.g. "Heating", "Monitoring")
`icon`	string	SF Symbol name (e.g. `"chart.xyaxis.line"`) or MDI icon with `mdi:` prefix
`accent_color`	string	Named color or hex. Default: `teal`
ॲप आवृत्ती 1.3.3 मध्ये येत आहे
`primary_series`	string	Names which series drives the headline value and the compact high/low range on iOS. Max 32 chars, and must match one of the `value` keys to take effect. When omitted (or naming an unknown key), the alphabetically-first series is used.

ℹ माहिती

The server accumulates history automatically — each push appends a timestamped data point. The history field in the response is read-only (client-supplied history is ignored). Up to 300 points per series are stored; APNs payloads are dynamically downsampled via LTTB to fit 4KB while preserving peaks and visual shape.

Example: Single Value

सर्व्हर तापमान निरीक्षण

{
  "state": "ongoing",
  "content": {
    "template": "timeline",
    "value": {"Temperature": 13.7},
    "unit": "°C",
    "state": "Heating",
    "icon": "thermometer.medium",
    "accent_color": "orange",
    "smoothing": true
  }
}

Example: Multi-Value with Thresholds

मिश्र युनिट्ससह सिस्टम आरोग्य

{
  "state": "ongoing",
  "content": {
    "template": "timeline",
    "value": {
      "CPU": 72.5,
      "GPU": 45.2,
      "Fan": 60.0,
      "SSD": 38.1
    },
    "unit": "%",
    "units": { "GPU": "°C", "SSD": "°C" },
    "state": "Monitoring",
    "primary_series": "CPU",
    "thresholds": [
      { "value": 80, "color": "red", "label": "Critical" },
      { "value": 60, "color": "orange" }
    ]
  }
}

ॲप आवृत्ती 1.3.3 मध्ये येत आहे

हा विभाग App Store पुनरावलोकनाच्या प्रतीक्षेत असलेल्या ॲप अपडेटमधील एका वैशिष्ट्याचे वर्णन करतो. अपडेट थेट होताच ते इथे आपोआप अनलॉक होईल.

Typical Flow

Start tracking (ended -> ongoing): Set initial value, unit, and display options (scale, smoothing, thresholds)
Send data points (ongoing -> ongoing): Push updated values — the sparkline grows with each push
Stop tracking (ongoing -> ended): Final value displayed, sparkline frozen

💡 टीप

Value-only updates are delivered at low priority to conserve the iOS push budget. Changing scale, smoothing, decimals, unit, or units triggers high-priority delivery.

Buttons & tap targets

Renders url_action and secondary_url_action as buttons below the sparkline; tap_action covers taps elsewhere on the widget. See Tap actions for the action object shape.

Use Cases

Server monitoring — CPU temperature, memory usage, network throughput over time
Smart home — room temperature trends, humidity tracking, energy consumption
3D printing — hotend/bed temperature curves during a print
CI/CD — build time trends, test suite duration over consecutive runs
IoT — sensor readings over time with threshold alerts