Example
Parcel delivery
An arrival window with a live progress bar.
{
"v": 1,
"preferredFamily": "systemMedium",
"refresh": 900,
"accessibility": "Running shoes arriving today between 09:05 and 10:05, 8 stops away",
"url": "https://track.example.com/parcels/7Q4K2",
"view": {
"type": "vstack",
"align": "leading",
"spacing": 0,
"padding": 14,
"children": [
{
"type": "hstack",
"spacing": 6,
"children": [
{
"type": "symbol",
"name": "shippingbox.fill",
"style": "subheadline",
"color": "orange",
"accentable": true
},
{
"type": "text",
"text": "Arriving today",
"style": "subheadline",
"weight": "semibold",
"color": "primary"
},
{"type": "spacer"},
{
"type": "text",
"text": "OUT FOR DELIVERY",
"style": "caption2",
"weight": "bold",
"color": "orange",
"padding": {"top": 2, "bottom": 2, "leading": 6, "trailing": 6},
"bg": "orange/15",
"corner": 5
}
]
},
{"type": "spacer", "minLength": 8},
{
"type": "text",
"style": "headline",
"lines": 1,
"spans": [
{"text": "Running shoes", "color": "primary"},
{"text": " and 2 more items", "color": "secondary", "weight": "regular"}
]
},
{
"type": "text",
"style": "subheadline",
"spans": [
{"text": "Between ", "color": "secondary"},
{
"text": "09:05",
"weight": "semibold",
"monoDigits": true,
"color": "primary"
},
{"text": " and ", "color": "secondary"},
{
"text": "10:05",
"weight": "semibold",
"monoDigits": true,
"color": "primary"
}
]
},
{"type": "spacer"},
{
"type": "gauge",
"from": "2026-08-11T07:05:00Z",
"until": "2026-08-11T10:05:00Z",
"tint": "orange",
"accentable": true
},
{"type": "spacer", "minLength": 6},
{
"type": "hstack",
"spacing": 5,
"children": [
{
"type": "symbol",
"name": "truck.box.fill",
"style": "caption",
"color": "secondary"
},
{
"type": "text",
"text": "8 stops away",
"style": "caption",
"color": "secondary"
},
{"type": "spacer"},
{
"type": "text",
"text": "Order 7Q4K2",
"style": "caption",
"color": "tertiary",
"monoDigits": true
}
]
}
]
}
} How it works
The bar is a gauge with from and until: the time the parcel left the depot and the end of its delivery window. The phone moves the bar every second between fetches. The server sends only the start and the end.
"Between 14:05 and 15:05" is one text made of spans. The times are bold with equal-width digits, the words are secondary, and the line wraps as one paragraph.
This payload has no background and no hex colour. The widget uses the system background, and its colours change with light and dark mode. Use the control above.
Put it on your Home Screen
We serve this example at the URL below. The server generates the timestamps at the time of each request. Add the URL as a hook in the app, and the widget works on your phone.
https://webhookwidget.com/demo/delivery Next
Family rota: Whose turn it is this week, shared with the household.
All examples