Example
The day ahead
Four scheduled views from one response.
{
"v": 1,
"preferredFamily": "systemLarge",
"refresh": 3600,
"accessibility": "Four meetings today, next is standup at 9",
"entries": [
{
"at": "2026-08-11T09:00:00Z",
"view": {
"type": "vstack",
"align": "leading",
"spacing": 10,
"padding": 16,
"bg": "white",
"children": [
{
"type": "hstack",
"children": [
{
"type": "vstack",
"align": "leading",
"spacing": -2,
"children": [
{
"type": "text",
"text": "TUESDAY",
"style": "caption2",
"weight": "bold",
"color": "red"
},
{
"type": "text",
"text": "11",
"size": 32,
"weight": "regular",
"color": "primary"
}
]
},
{"type": "spacer"},
{
"type": "text",
"text": "4 to go",
"style": "caption",
"weight": "semibold",
"color": "secondary"
}
]
},
{
"type": "text",
"text": "NOW",
"style": "caption2",
"weight": "bold",
"color": "blue"
},
{
"type": "hstack",
"spacing": 10,
"w": "fill",
"padding": 10,
"bg": "blue/12",
"corner": 10,
"children": [
{"type": "rect", "w": 4, "fill": "blue", "corner": 2},
{
"type": "vstack",
"align": "leading",
"spacing": 2,
"children": [
{
"type": "text",
"text": "Standup",
"style": "title3",
"weight": "semibold",
"color": "primary",
"lines": 2
},
{
"type": "text",
"text": "09:00 – 09:15",
"style": "subheadline",
"weight": "medium",
"color": "blue",
"monoDigits": true
},
{
"type": "text",
"text": "Team sync · Zoom",
"style": "footnote",
"color": "secondary",
"lines": 1
}
]
},
{"type": "spacer"}
]
},
{
"type": "text",
"text": "LATER",
"style": "caption2",
"weight": "bold",
"color": "tertiary"
},
{
"type": "vstack",
"align": "leading",
"spacing": 6,
"overflow": "drop",
"more": {
"type": "text",
"text": "+{count} more",
"style": "caption",
"color": "secondary"
},
"children": [
{
"type": "hstack",
"spacing": 8,
"children": [
{"type": "rect", "w": 3, "fill": "purple", "corner": 1.5},
{
"type": "vstack",
"align": "leading",
"spacing": 0,
"children": [
{
"type": "text",
"text": "Design review",
"style": "subheadline",
"weight": "medium",
"color": "primary",
"lines": 1
},
{
"type": "text",
"text": "11:30",
"style": "caption",
"color": "secondary",
"monoDigits": true
}
]
}
]
},
{
"type": "hstack",
"spacing": 8,
"children": [
{"type": "rect", "w": 3, "fill": "teal", "corner": 1.5},
{
"type": "vstack",
"align": "leading",
"spacing": 0,
"children": [
{
"type": "text",
"text": "1:1 with Alex",
"style": "subheadline",
"weight": "medium",
"color": "primary",
"lines": 1
},
{
"type": "text",
"text": "14:00",
"style": "caption",
"color": "secondary",
"monoDigits": true
}
]
}
]
},
{
"type": "hstack",
"spacing": 8,
"children": [
{"type": "rect", "w": 3, "fill": "orange", "corner": 1.5},
{
"type": "vstack",
"align": "leading",
"spacing": 0,
"children": [
{
"type": "text",
"text": "Sprint 42 retro",
"style": "subheadline",
"weight": "medium",
"color": "primary",
"lines": 1
},
{
"type": "text",
"text": "16:30",
"style": "caption",
"color": "secondary",
"monoDigits": true
}
]
}
]
}
]
},
{"type": "spacer"}
]
}
},
{
"at": "2026-08-11T11:30:00Z",
"view": {
"type": "vstack",
"align": "leading",
"spacing": 10,
"padding": 16,
"bg": "white",
"children": [
{
"type": "hstack",
"children": [
{
"type": "vstack",
"align": "leading",
"spacing": -2,
"children": [
{
"type": "text",
"text": "TUESDAY",
"style": "caption2",
"weight": "bold",
"color": "red"
},
{
"type": "text",
"text": "11",
"size": 32,
"weight": "regular",
"color": "primary"
}
]
},
{"type": "spacer"},
{
"type": "text",
"text": "3 to go",
"style": "caption",
"weight": "semibold",
"color": "secondary"
}
]
},
{
"type": "text",
"text": "NOW",
"style": "caption2",
"weight": "bold",
"color": "purple"
},
{
"type": "hstack",
"spacing": 10,
"w": "fill",
"padding": 10,
"bg": "purple/12",
"corner": 10,
"children": [
{"type": "rect", "w": 4, "fill": "purple", "corner": 2},
{
"type": "vstack",
"align": "leading",
"spacing": 2,
"children": [
{
"type": "text",
"text": "Design review",
"style": "title3",
"weight": "semibold",
"color": "primary",
"lines": 2
},
{
"type": "text",
"text": "11:30 – 12:30",
"style": "subheadline",
"weight": "medium",
"color": "purple",
"monoDigits": true
},
{
"type": "text",
"text": "With Priya and Sam · Room 4B",
"style": "footnote",
"color": "secondary",
"lines": 1
}
]
},
{"type": "spacer"}
]
},
{
"type": "text",
"text": "LATER",
"style": "caption2",
"weight": "bold",
"color": "tertiary"
},
{
"type": "vstack",
"align": "leading",
"spacing": 6,
"overflow": "drop",
"more": {
"type": "text",
"text": "+{count} more",
"style": "caption",
"color": "secondary"
},
"children": [
{
"type": "hstack",
"spacing": 8,
"children": [
{"type": "rect", "w": 3, "fill": "teal", "corner": 1.5},
{
"type": "vstack",
"align": "leading",
"spacing": 0,
"children": [
{
"type": "text",
"text": "1:1 with Alex",
"style": "subheadline",
"weight": "medium",
"color": "primary",
"lines": 1
},
{
"type": "text",
"text": "14:00",
"style": "caption",
"color": "secondary",
"monoDigits": true
}
]
}
]
},
{
"type": "hstack",
"spacing": 8,
"children": [
{"type": "rect", "w": 3, "fill": "orange", "corner": 1.5},
{
"type": "vstack",
"align": "leading",
"spacing": 0,
"children": [
{
"type": "text",
"text": "Sprint 42 retro",
"style": "subheadline",
"weight": "medium",
"color": "primary",
"lines": 1
},
{
"type": "text",
"text": "16:30",
"style": "caption",
"color": "secondary",
"monoDigits": true
}
]
}
]
}
]
},
{"type": "spacer"}
]
}
},
{
"at": "2026-08-11T14:00:00Z",
"view": {
"type": "vstack",
"align": "leading",
"spacing": 10,
"padding": 16,
"bg": "white",
"children": [
{
"type": "hstack",
"children": [
{
"type": "vstack",
"align": "leading",
"spacing": -2,
"children": [
{
"type": "text",
"text": "TUESDAY",
"style": "caption2",
"weight": "bold",
"color": "red"
},
{
"type": "text",
"text": "11",
"size": 32,
"weight": "regular",
"color": "primary"
}
]
},
{"type": "spacer"},
{
"type": "text",
"text": "2 to go",
"style": "caption",
"weight": "semibold",
"color": "secondary"
}
]
},
{
"type": "text",
"text": "NOW",
"style": "caption2",
"weight": "bold",
"color": "teal"
},
{
"type": "hstack",
"spacing": 10,
"w": "fill",
"padding": 10,
"bg": "teal/12",
"corner": 10,
"children": [
{"type": "rect", "w": 4, "fill": "teal", "corner": 2},
{
"type": "vstack",
"align": "leading",
"spacing": 2,
"children": [
{
"type": "text",
"text": "1:1 with Alex",
"style": "title3",
"weight": "semibold",
"color": "primary",
"lines": 2
},
{
"type": "text",
"text": "14:00 – 14:30",
"style": "subheadline",
"weight": "medium",
"color": "teal",
"monoDigits": true
},
{
"type": "text",
"text": "Career check-in",
"style": "footnote",
"color": "secondary",
"lines": 1
}
]
},
{"type": "spacer"}
]
},
{
"type": "text",
"text": "LATER",
"style": "caption2",
"weight": "bold",
"color": "tertiary"
},
{
"type": "vstack",
"align": "leading",
"spacing": 6,
"overflow": "drop",
"more": {
"type": "text",
"text": "+{count} more",
"style": "caption",
"color": "secondary"
},
"children": [
{
"type": "hstack",
"spacing": 8,
"children": [
{"type": "rect", "w": 3, "fill": "orange", "corner": 1.5},
{
"type": "vstack",
"align": "leading",
"spacing": 0,
"children": [
{
"type": "text",
"text": "Sprint 42 retro",
"style": "subheadline",
"weight": "medium",
"color": "primary",
"lines": 1
},
{
"type": "text",
"text": "16:30",
"style": "caption",
"color": "secondary",
"monoDigits": true
}
]
}
]
}
]
},
{"type": "spacer"}
]
}
},
{
"at": "2026-08-11T16:30:00Z",
"view": {
"type": "vstack",
"align": "leading",
"spacing": 10,
"padding": 16,
"bg": "white",
"children": [
{
"type": "hstack",
"children": [
{
"type": "vstack",
"align": "leading",
"spacing": -2,
"children": [
{
"type": "text",
"text": "TUESDAY",
"style": "caption2",
"weight": "bold",
"color": "red"
},
{
"type": "text",
"text": "11",
"size": 32,
"weight": "regular",
"color": "primary"
}
]
},
{"type": "spacer"},
{
"type": "text",
"text": "1 to go",
"style": "caption",
"weight": "semibold",
"color": "secondary"
}
]
},
{
"type": "text",
"text": "NOW",
"style": "caption2",
"weight": "bold",
"color": "orange"
},
{
"type": "hstack",
"spacing": 10,
"w": "fill",
"padding": 10,
"bg": "orange/12",
"corner": 10,
"children": [
{"type": "rect", "w": 4, "fill": "orange", "corner": 2},
{
"type": "vstack",
"align": "leading",
"spacing": 2,
"children": [
{
"type": "text",
"text": "Sprint 42 retro",
"style": "title3",
"weight": "semibold",
"color": "primary",
"lines": 2
},
{
"type": "text",
"text": "16:30 – 17:30",
"style": "subheadline",
"weight": "medium",
"color": "orange",
"monoDigits": true
},
{
"type": "text",
"text": "Whole team · Big room",
"style": "footnote",
"color": "secondary",
"lines": 1
}
]
},
{"type": "spacer"}
]
},
{
"type": "text",
"text": "Nothing else today.",
"style": "subheadline",
"color": "secondary"
},
{"type": "spacer"}
]
}
}
]
} How it works
The response has four entries, each with a time and a view. The phone changes to each view at its time, without another fetch.
iOS decides when a widget refreshes. A response that holds the whole day keeps the widget correct at 09:00, 11:30, 14:00 and 16:30, even when iOS allows few fetches.
The coloured bar on each event is a rect with a width and no height. A shape stretches across its stack, so in an hstack beside a block of text the bar is as tall as the text, for one line or three. The card behind the event is the event's colour at 12%: purple/12.
Use the entry control above the preview to see what the phone shows at each time.
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/agenda Next
Launch countdown: Five ways to display the same date.
All examples