Timeline
Events in order, each with a marker and a line to the next. New events fade in while the rest glide to make room, and a step’s line fills as it completes.
Examples
Default
An issue’s activity, with an avatar or an icon as each marker. Comment: the new event fades in at the top, and Undo takes it away again.
Status
status makes each event a step. Next step: the line out of the current one fills, then the next marker lights.
Icons
A marker holds an icon, such as a spinner on the step running now. Redeploy: each icon crossfades to a tick as its step completes.
Split
variant="split" centres the rail and puts each TimelineAside on its other side. Below 28rem wide, the aside goes above the title.
Split with status
A roadmap: the aside holds the quarter, and the steps fill as they ship.
Installation
npx shadcn@latest add https://kinoui.com/r/timeline.json- Files
lib/reduce-motion.tslib/resize.tslib/run-progress.tslib/highlight.tslib/flow.tslib/refs.tslib/step.tslib/swap.tsxcomponents/kino/timeline.tsx- Packages
@base-ui/react- Global CSS
- the feels, the density tokens, the shape tokens and the success and warning colours
New to Kino? Installation covers what your project needs first and the @kino namespace.
API reference
Timeline
TimelineItem
Data attributes
CSS variables
Accessibility
- The timeline is an ordered list. Name it with
aria-labeloraria-labelledby. - A step reads its status before its title: “Completed” or “Upcoming”, and the current step is
aria-current="step". In forced colours the current marker takes an outline, so the status never relies on colour. - Markers and lines are hidden from screen readers: the title says what happened.
- Events aren’t focusable. Tab moves through the links and buttons inside them.
- When events arrive, announce them yourself in a
role="status"region. - When the system asks for less motion, events move at once and only fade, and a step’s colours change without waiting for its line.