Components · Planning
Board
A read-only status board (kanban). columns (1-12) each have a title, optional tone, optional count (shown instead of the card count when the column lists only some cards), and cards. A card has a title, optional short body, tone, up to 4 badges ({ label, tone }), owner, and due (ISO date such as 2026-11-06). Up to 500 cards in all. Phones scroll the columns sideways inside the board.
ExamplesLink to this section
To do, 2 cards
Write the release notes
Owner DanaDue
Plan the billing page
Seats, invoices, and upgrades.
- design
In progress, 2 cards
Calendar component
- ui
Owner claude-opusDue
Fix share dialog overflow
- bug
Owner Sam
Done, 42 cards
Pie and donut charts
Show JSONHide JSON
{
"version": 1,
"root": "board",
"elements": {
"board": {
"type": "Board",
"props": {
"title": "Sprint 14",
"columns": [
{
"title": "To do",
"cards": [
{
"title": "Write the release notes",
"owner": "Dana",
"due": "2026-11-12"
},
{
"title": "Plan the billing page",
"body": "Seats, invoices, and upgrades.",
"badges": [{ "label": "design", "tone": "info" }]
}
]
},
{
"title": "In progress",
"tone": "info",
"cards": [
{
"title": "Calendar component",
"owner": "claude-opus",
"due": "2026-11-06",
"badges": [{ "label": "ui", "tone": "info" }]
},
{
"title": "Fix share dialog overflow",
"tone": "warning",
"badges": [{ "label": "bug", "tone": "danger" }],
"owner": "Sam"
}
]
},
{
"title": "Done",
"tone": "success",
"count": 42,
"cards": [{ "title": "Pie and donut charts", "tone": "success" }]
}
]
}
}
}
}PropsLink to this section
Generated from the zod schema the server validates with. Unknown props are ignored with a warning. Any prop can also be a dynamic value such as { "$state": "/path" }; it is checked again once it resolves.
| Prop | Type | Limits and defaults |
|---|---|---|
| title | string | max 160 chars |
| columnsrequired | object[] | 1–12 items |
| columns[].titlerequired | string | max 80 chars |
| columns[].tone | "neutral" | "info" | "success" | "warning" | "danger" | — |
| columns[].count | integer | 0–1,000,000 |
| columns[].cardsrequired | object[] | max 200 items |
| columns[].cards[].titlerequired | string | max 200 chars |
| columns[].cards[].body | string | max 500 chars |
| columns[].cards[].tone | "neutral" | "info" | "success" | "warning" | "danger" | — |
| columns[].cards[].badges | object[] | max 4 items |
| columns[].cards[].badges[].labelrequired | string | max 40 chars |
| columns[].cards[].badges[].tone | "neutral" | "info" | "success" | "warning" | "danger" | — |
| columns[].cards[].owner | string | max 60 chars |
| columns[].cards[].due | string | max 10 chars |
RulesLink to this section
- Up to 500 cards across all columns.
countreplaces the shown card count, for a column that lists only some of its cards. It cannot be lower than the cards shown.dueis an ISO date such as 2026-11-06. Readers cannot drag cards; save a new version to move one.
Children and eventsLink to this section
Board is a leaf: it does not show children. Validation warns when a leaf has some; wrap them in a Stack or Card instead.
It emits no events.