Agenda
FreeA read-only list of what happens when, with a time, a colour bar and a title on every row.
npx wunderui-cli add agendaPlayground
Team standup
Daily sync with product
Design review
WunderUI v3 components
Client call
Q3 roadmap discussion
Team standup
Design review
Client call
Team standup
Daily sync with product
Design review
WunderUI v3 components
Client call
Q3 roadmap discussion
Installation
npx wunderui-cli add agendaWrites the source into your project with its dependencies and, on first use, the styles - see Installation.
Then import what you need:
import { Agenda } from "@/components/wunderui/agenda"
import type { AgendaItem } from "@/components/wunderui/agenda"Then use it:
import { Agenda } from "@/components/ui/agenda"
export function Today() {
return (
<Agenda
items={[
{ id: "standup", time: "09:00", title: "Team standup", description: "Daily sync with product" },
{ id: "review", time: "11:00", title: "Design review", description: "WunderUI v3 components" },
{ id: "client", time: "14:00", title: "Client call", description: "Q3 roadmap discussion" },
]}
/>
)
}Expected result: You should see a bordered list of three rows, each with its time on the left, a coloured bar and a title with a description.
When to use
Use Agenda for
- A short, read-only list of what happens when, such as a day's meetings
- A programme or run of show with one time per row
- A compact Today list on a dashboard or in a side panel
Use something else for
- Agenda Event for rows with guests, a menu or an action that opens the event
- Timeline for events that already happened, with a status and an exact date
- Calendar for picking a day or browsing a month
Content
Each row is a time and a title. Add a description for a place, person or status, and long text wraps so the row grows.
Team standup
Design review
Client call
Team standup
Daily sync with product
Design review
WunderUI v3 components
Client call
Q3 roadmap discussion
Quarterly planning workshop with the product, design and engineering leads
Review the Q3 roadmap, agree on the scope for the next release and decide who owns each open question before Friday.
Lunch with Maya Kessler
Garden Street Café
Colour
The bar takes the primary colour. Give an entry a token to colour it by status or category, and say the same in the text.
Team standup
Daily sync with product
Design review
WunderUI v3 components
Client call
Q3 roadmap discussion
Team standup
Confirmed
Design review
Waiting for a reply from Priya Raman
Client call
Cancelled
Team standup
Meeting
Design review
Review
Focus time
No meetings
Client call
Customer
Width
The list fills the width of its parent. Set a width with a class, and the time column keeps its size while the text wraps.
Team standup
Daily sync with product
Design review
WunderUI v3 components
Client call
Q3 roadmap discussion
Team standup
Daily sync with product
Design review
WunderUI v3 components
Client call
Q3 roadmap discussion
Team standup
Daily sync with product
Design review
WunderUI v3 components
Client call
Q3 roadmap discussion
Behavior and motion
What the list does with order, content, the DOM and motion.
- Order is yours
- Items render in array order. The list does not sort by time or group by day.
- Time is plain text
- The time is printed as written, not parsed: no time zone, no 12 or 24 hour format, no relative time. The column is 56 px wide; longer values wrap.
- Colour is an inline style
- The colour goes straight into the bar's background. Use a token such as var(--success), since a hex ignores theme and dark mode; the default is primary.
- Rows are static
- A row has no hover, pressed, focus or selected state and is not in the tab order, but its text can be selected. For a row that opens something, use Agenda Event.
- Plain markup
- The list and rows are plain divs, with no list or time elements, so a screen reader reads each row as text, time first. Put a heading near the list.
- Long text
- Long titles and descriptions wrap and the bar grows with the row. Nothing is truncated.
- Empty list
- With no items the list draws an empty bordered box with no height. Show an Empty State when there is nothing to list.
- Motion and reduced motion
- Nothing animates: rows appear, change and leave without a transition. There is nothing to reduce.
Anatomy
The parts the list is made of, numbered in the figure.
Team standup
Daily sync with product
Design review
WunderUI v3 components
- 1
The bordered, rounded list, one row per item in array order. It does not sort by time.
- 2
One entry with 16 px padding and a line below it, except the last. Rows are text only, with no click or focus state.
- 3
The time string as written, in a narrow fixed column on the left. A long value wraps.
- 4Optional
A 2 px bar the height of the row, in the item's colour (the primary colour if none is set).
- 5
The title in semibold text. A long title wraps.
- 6Optional
An optional line under the title in smaller secondary text, for a place, a person or a status.
Best practices
- Do
Sort the items by time before you pass them in. The list renders them in array order and never reorders.
- Do
Use one short time format across the list, such as 09:30. The time column is 56 px wide, so a range such as 09:00 to 10:30 wraps onto a second line.
- Do
Set the colour to a CSS variable such as var(--brand-secondary), not a hex. Only a token follows the theme and dark mode.
- Do
Say what an entry is in its title or description, like Cancelled or Review. The bar is only a colour and does not reach people who cannot tell hues apart.
- Don’t
Don't make the Agenda clickable by wrapping it in a link or button. Rows have no hover or focus state; use Agenda Event when an entry opens something.
- Don’t
Don't put the Agenda inside another bordered card. It already has its own border and background, so a second box doubles the lines.
API reference
Agenda is a plain list. It takes the props below and passes nothing else to its element.
The bordered, rounded list, one row per item in array order. It does not sort by time.
| Prop | Type | Default | Description |
|---|---|---|---|
| items required | { id: string; time: string; title: string; description?: string; color?: string }[] | — | The entries, in the order they appear. Each has an (the React key, unique in the list), a shown as written, a , an optional under it and an optional , a CSS colour for the bar, best a token such as . Without the bar is . |
| className | string | — | Extra classes for the list, merged after the defaults. Use it to set a width such as , or a margin. The list fills the width of its parent otherwise. |
Notes for AI
Give your coding assistant the Markdown reference instead of screenshots.
get_component("agenda")npx wunderui-cli add agendaThe full library index for assistants is at /llms.txt.