Skip to content
VenusUI
Get started

Timeline

A vertical timeline for changelogs, roadmaps and history.

Preview

Installation

npx shadcn@latest add @venusui/timeline

Run this in a project set up with shadcn. If you haven’t set it up yet, run npx shadcn@latest init first.

Files added to your project

Paths use the default shadcn aliases. The CLI follows the aliases in your components.json.

  • @/components/ui/timeline.tsx

Usage

The code behind the preview above.

timeline-demo.tsx

import { Timeline } from "@/components/ui/timeline"

export default function TimelineDemo() {
  return (
    <Timeline
      className="max-w-md"
      entries={[
        { id: "v3", date: "Nov 2026", dateTime: "2026-11", title: "Version 3.0", description: "3D components and a new docs layout.", current: true },
        { id: "v2", date: "Aug 2026", dateTime: "2026-08", title: "Version 2.0", description: "Blocks for heroes, pricing and footers." },
        { id: "v1", date: "May 2026", dateTime: "2026-05", title: "Version 1.0", description: "First public release." },
      ]}
    />
  )
}

API reference

PropTypeDefaultDescription
entries{ id: string; date: string; dateTime?: string; title: ReactNode; description?: ReactNode; current?: boolean }[]—Entries, newest first. dateTime fills the <time> element. Required.

All <ol> props except children.

Requirements

  • Tailwind CSS v4. Works in Server Components.

Customization

  • Mark the latest entry with current to highlight its marker.
  • Put links or badges in description.

Accessibility

  • An ordered list with <time> dates and h3 titles. The current entry is announced as “(current)”.

Troubleshooting

Markers don’t sit on the line.
They are positioned for the default pl-6; adjust -left-[1.95rem] if you change the padding.
Unknown registry "@venusui"
Your shadcn CLI couldn’t find the namespace in the shadcn registry index. Use the latest CLI (npx shadcn@latest), install by URL, or register it with its address: npx shadcn@latest registry add @venusui=https://venusui.com/r/{name}.json.
No components.json found
Run npx shadcn@latest init in your project first.
Loading preview

Analog Clock

Data display

A station clock whose needle waits at twelve; drag the minute hand to set it by hand.

Loading preview

Avatar Stack

Data display

Overlapping avatars with a +N counter that spread apart on hover.

Loading preview

Bookshelf

Interactive

Books on a wooden shelf whose spines lift on hover and pull out when selected, with a matching cover.