# Agenda

A time-ordered list of scheduled events.

- Category: Core Elements
- Page: https://wunderui.com/components/agenda
- Tier: Free

## Install

```bash
npx wunderui-cli add agenda
```

## Import

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

## Minimal usage

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.

## Usage

```tsx
import { Agenda } from "@/components/ui/agenda"

export function Example() {
  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" },
      ]}
    />
  )
}
```

## 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

- [Agenda Event](https://wunderui.com/components/agenda-event) for rows with guests, a menu or an action that opens the event
- [Timeline](https://wunderui.com/components/timeline) for events that already happened, with a status and an exact date
- [Calendar](https://wunderui.com/components/calendar) for picking a day or browsing a month

## Behavior

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

- `Agenda`: The bordered, rounded list, one row per item in array order. It does not sort by time.
- `Row`: One entry with 16 px padding and a line below it, except the last. Rows are text only, with no click or focus state.
- `Time`: The time string as written, in a narrow fixed column on the left. A long value wraps.
- `Colour bar`: A 2 px bar the height of the row, in the item's colour (the primary colour if none is set).
- `Title`: The title in semibold text. A long title wraps.
- `Description`: An optional line under the title in smaller secondary text, for a place, a person or a status.

## Best practices

### When to use

- Use an Agenda for a short, read-only list of what happens when. For past events in order use Timeline; for rows with guests, a menu or a click, use Agenda Event.

### Do

- Sort the items by time before you pass them in. The list renders them in array order and never reorders.
- 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.
- Set the colour to a CSS variable such as var(--brand-secondary), not a hex. Only a token follows the theme and dark mode.
- 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 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

| Prop | Type | Default | Description |
|---|---|---|---|
| items* | { id: string; time: string; title: string; description?: string; color?: string }[] |  | The entries, in the order they appear. Each has an `id` (the React key, unique in the list), a `time` shown as written, a `title`, an optional `description` under it and an optional `color`, a CSS colour for the bar, best a token such as `var(--success)`. Without `color` the bar is `var(--primary)`. |
| className | string |  | Extra classes for the list, merged after the defaults. Use it to set a width such as `w-80`, or a margin. The list fills the width of its parent otherwise. |

## Examples

### Content: title only, with a description and long text

```tsx
import { Agenda } from "@/components/ui/agenda"

export function Example() {
  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" },
      ]}
    />
  )
}
```

### Colour: primary, status and category

```tsx
import { Agenda } from "@/components/ui/agenda"

export function Example() {
  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" },
      ]}
    />
  )
}
```

### Width: fills the parent or takes a width

```tsx
import { Agenda } from "@/components/ui/agenda"

export function Example() {
  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" },
      ]}
    />
  )
}
```

## In context

### Today: a schedule with a heading and a count

```tsx
import { Agenda } from "@/components/ui/agenda"
import { Badge } from "@/components/ui/badge"

export function TodayPanel() {
  return (
    <section className="mx-auto flex w-full max-w-[420px] flex-col gap-3">
      <div className="flex items-center justify-between gap-3">
        <div className="flex flex-col">
          <h2 className="text-sm font-semibold text-foreground">Today</h2>
          <p className="text-xs text-text-secondary">Tuesday, Nov 10</p>
        </div>
        <Badge color="indigo" badgeStyle="light" shape="pill" className="h-5 px-2 text-xs">3 events</Badge>
      </div>
      <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" },
        ]}
      />
    </section>
  )
}
```

### Programme: a half-day schedule with the speaker in the description

```tsx
import { Agenda } from "@/components/ui/agenda"

export function Programme() {
  return (
    <section className="mx-auto flex w-full max-w-[420px] flex-col gap-3">
      <h2 className="text-sm font-semibold text-foreground">Product workshop, Nov 12: morning</h2>
      <Agenda
        items={[
          {
            id: "doors",
            time: "09:00",
            title: "Doors open",
            description: "Coffee and name badges in the foyer",
            color: "var(--brand-secondary)",
          },
          { id: "welcome", time: "09:30", title: "Welcome and goals", description: "Nora Lindgren, Room Aurora" },
          {
            id: "tokens",
            time: "10:15",
            title: "Design tokens in practice",
            description: "Daniel Okafor, Room Aurora",
            color: "var(--chart-3)",
          },
          { id: "break", time: "11:30", title: "Break", color: "var(--success)" },
        ]}
      />
    </section>
  )
}
```

### Empty day: an Empty State instead of an empty list

```tsx
import { Agenda } from "@/components/ui/agenda"
import { Badge } from "@/components/ui/badge"

export function TodayPanel() {
  return (
    <section className="mx-auto flex w-full max-w-[420px] flex-col gap-3">
      <div className="flex items-center justify-between gap-3">
        <div className="flex flex-col">
          <h2 className="text-sm font-semibold text-foreground">Today</h2>
          <p className="text-xs text-text-secondary">Tuesday, Nov 10</p>
        </div>
        <Badge color="indigo" badgeStyle="light" shape="pill" className="h-5 px-2 text-xs">4 events</Badge>
      </div>
      <Agenda
        items={[
          { id: "standup", time: "09:00", title: "Team standup", description: "Meeting" },
          {
            id: "review",
            time: "11:00",
            title: "Design review",
            description: "Review",
            color: "var(--brand-secondary)",
          },
          { id: "focus", time: "13:00", title: "Focus time", description: "No meetings", color: "var(--chart-3)" },
          { id: "client", time: "14:00", title: "Client call", description: "Customer", color: "var(--success)" },
        ]}
      />
    </section>
  )
}
```

## For AI agents

`get_component("agenda")`

Hand your agent this page as Markdown or the WunderUI MCP server, not a screenshot.
