Timeline

Events in order along a vertical line, with a dot per event that can carry its own color or glyph.

Basic

Pass items with a content for each event, and Timeline draws them in order down a rail with a dot for each.

Color

Set an item's color to a color name like blue or violet, or any CSS color.

Variant

Set variant to filled to draw each dot as a solid circle instead of the default outlined ring.

Icons

Pass an item's icon to replace its dot, like a check for a passed build or a spinner for one still running.

Shape

Set shape to circle, square or squircle to put each item's icon in a box, colored by the item's color.

Size

Set size="small" to draw the shape boxes smaller, for a dense feed or a sidebar.

Box variant

With a shape, set variant to outlined, filled or solid to draw the box as a surface, a tint of the item's color or that color in full.

Alternate mode

Set mode="alternate" to put each title and content on opposite sides, and placement on one item to move that row.

End mode

Set mode="end" to move the rail to the end side, with the content before it, which flips in a right-to-left layout.

Orientation

Set orientation="horizontal" to lay the items out in a row, like the steps of a checkout.

Shape in a row

Combine orientation="horizontal" with shape to draw each step of a checkout as a box on the rail.

Title span

Set titleSpan to size the column the titles sit in, as a column count out of 24 or as a CSS width string.

Loading item

Set loading on an item to mark it in progress, and give it a spinning icon so the spinner comes from your icon pack.

Reverse

Set reverse to show the items in the opposite order without changing the array, like an invoice history shown newest first.

In context

The component inside real screens, with the components it usually sits beside.

Agent run trace

An agent's run log with each tool call as an item, a Tag for the tool name, and a failed call followed by its retry.

LLM conversation

A chat history in mode="alternate", with the speaker in title on one side and what they said in content on the other.

Moderation pipeline

A moderation pipeline where each item's color shows the verdict at that stage, from gray while queued to green once cleared.

Project roadmap

A roadmap in mode="alternate", with a date in each title and a milestone card with its team in each content.

Audit log

An audit log where routine entries stay gray and the one blocked sign-in is marked with color="red".

Approval workflow

An approval flow with a blocked step that has a warning icon, how long it has waited and buttons to act on it.

API Reference

Timeline
Timeline's props.
Items
The props of one entry in items.