labsUI

Timeline

Server-safe ordered list of events on a rail: icon or dot markers with status colors, machine-readable <time>, title and an optional body. For changelogs, experience and mod logs.

npx @kznlabs/labsui add timeline
  1. v0.3 released

    Table, Input OTP, Timeline, Spinner and Aspect ratio.
  2. Merged #128

    Command palette keyword matching.
  3. Rate limit raised

  4. Sep 30, 2026

    v0.2 tagged

  5. Sep 2, 2026

    Project started

<Timeline>

Ordered list of events, newest or oldest first; the order is yours.

Also accepts every <ol> prop (none of its own).

<TimelineItem>

One event: marker on the rail, then time, title and optional body (children).

  • title*
    ReactNode

    Event headline.

  • dateTime
    string

    Machine-readable date for <time>, e.g. "2026-10-21".

  • icon
    ReactNode

    Icon inside the marker; without one the marker is a small dot.

  • time
    ReactNode

    Shown above the title. Pair with dateTime to render a machine-readable <time>.

  • variantdefault "default"
    "default" | "active" | "success" | "warning" | "destructive"

    Marker color.

PropTypeDefault
title*

Event headline.

ReactNode—
dateTime

Machine-readable date for <time>, e.g. "2026-10-21".

string—
icon

Icon inside the marker; without one the marker is a small dot.

ReactNode—
time

Shown above the title. Pair with dateTime to render a machine-readable <time>.

ReactNode—
variant

Marker color.

"default" | "active" | "success" | "warning" | "destructive""default"

Also accepts every <li> prop.

* required. Every component also takes className.