Skip to contentKino
Skip to Content

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.

npx shadcn add https://kinoui.com/r/timeline.json
Share on

Examples

KN-482 activity

  1. Lucía Fernández commented

    Tested on the Pixel 8 with the network off for an hour. Notes sync in order once it comes back.

  2. Kenji Watanabe moved this to In review
  3. Amara Okafor assigned Kenji Watanabe
  4. Tobias Lindqvist created KN-482

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.

Order #10482

  1. Completed
    Order placed

    Paid with Visa ending 4242.

  2. Completed
    Packed

    Two parcels, 3.2 kg.

  3. Shipped

    In transit with DHL, tracking 1Z 999 AA1 0123 4567 84.

  4. Upcoming
    Out for delivery
  5. Upcoming
    Delivered

Status

status makes each event a step. Next step: the line out of the current one fills, then the next marker lights.

Deploy · main@8f3c2e1

  1. Completed
    Queued
  2. Completed
    Build
  3. Completed
    Checks
  4. Completed
    Live on kinoui.com

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.

Release notes

  1. v2.4
    Offline sync

    Notes you take with no signal are kept on the device and sync in order once you’re back online. Read the notes

  2. v2.3
    Shared projects and guest access

    Invite people outside your workspace to one project, with read-only or comment access. Read the notes

  3. v2.2
    Faster search

    Search now finds words inside photos and attached PDFs, and opens in under 100 ms. Read the notes

Split

variant="split" centres the rail and puts each TimelineAside on its other side. Below 28rem wide, the aside goes above the title.

Roadmap

  1. Completed
    Q3 2026
    Field notes on mobile

    iOS and Android apps, with photos and voice notes.

  2. Q4 2026
    Offline sync

    Take notes with no signal; they sync in order later.

  3. Upcoming
    Q1 2027
    Shared maps

    Pin notes to a map the whole team can see.

  4. Upcoming
    Q2 2027
    Reports

    Turn a week of notes into a PDF for the client.

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

New to Kino? Installation covers what your project needs first and the @kino namespace.

API reference

Timeline

PropTypeDefaultDescription
variant"default""split""default"Default puts the rail at the start edge. Split centres it, with each event’s TimelineAside on the other side; it fills its parent’s width, so don’t put it in a box that sizes to its content.
containerClassNamestringNoneClasses for the box around the list.

TimelineItem

PropTypeDefaultDescription
status"complete""current""upcoming"NoneMakes the event a step. Its marker fills when complete, is ringed when current and hollow when upcoming, and a complete step’s line fills along its length. Leave it out for an event that has happened.

Data attributes

AttributeOnDescription
data-variant[data-slot=timeline-list]The variant.
data-statusTimelineItemThe step’s status, when it has one.
data-dotTimelineMarkerPresent when the marker is a dot.
data-flowingTimelineItemPresent while the event glides to a new place.

CSS variables

VariableSet it onDefaultDescription
--timeline-markerTimelinevar(--control-height-xs)The width of the rail, and the size of a marker that holds an icon.
--timeline-gapTimelinevar(--surface-gap)The space between events.

Accessibility

  • The timeline is an ordered list. Name it with aria-label or aria-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.