Skip to content
WunderUI

Agenda

Free

A read-only list of what happens when, with a time, a colour bar and a title on every row.

npx wunderui-cli add agenda

Playground

09:00

Team standup

Daily sync with product

11:00

Design review

WunderUI v3 components

14:00

Client call

Q3 roadmap discussion

Installation

bash
npx wunderui-cli add agenda

Writes the source into your project with its dependencies and, on first use, the styles - see Installation.

Then import what you need:

tsx
import { Agenda } from "@/components/wunderui/agenda"
import type { AgendaItem } from "@/components/wunderui/agenda"

Then use it:

tsx
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.

09:00

Team standup

Daily sync with product

11:00

Design review

WunderUI v3 components

14:00

Client call

Q3 roadmap discussion

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.

09:00

Team standup

Daily sync with product

11:00

Design review

WunderUI v3 components

14:00

Client call

Q3 roadmap discussion

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.

09:00

Team standup

Daily sync with product

11:00

Design review

WunderUI v3 components

14:00

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.

09:00

Team standup

Daily sync with product

11:00

Design review

WunderUI v3 components

  • The bordered, rounded list, one row per item in array order. It does not sort by time.

  • One entry with 16 px padding and a line below it, except the last. Rows are text only, with no click or focus state.

  • The time string as written, in a narrow fixed column on the left. A long value wraps.

  • Optional

    A 2 px bar the height of the row, in the item's colour (the primary colour if none is set).

  • The title in semibold text. A long title wraps.

  • Optional

    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.

PropTypeDefaultDescription
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 .
classNamestring—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.

MCPget_component("agenda")
Installnpx wunderui-cli add agenda

The full library index for assistants is at /llms.txt.