Timeline
Tailwind vertical timeline with a hairline rail, a dot per event, titles, optional descriptions and right-aligned timestamps for activity feeds and changelogs.
src/registry/ui/timeline.tsx/r/timeline.json
Installation#
bash
npx shadcn@latest add @minidev/timeline
MiniDev UI is in the shadcn registry directory, so the short form works with no setup. Older CLI versions can use the full URL: npx shadcn@latest add https://ui.minidev.pro/r/timeline.json
Usage#
tsx
import { Timeline } from "@/components/ui/timeline"
export function Example() {
return (
<Timeline className="max-w-md" items={[
{ title: "Deployed v0.1", description: "Batch A shipped", time: "2h ago" },
{ title: "Audit green", description: "All gallery routes passed", time: "3h ago" },
{ title: "Scaffold", description: "Next + shadcn", time: "5h ago" },
]} />
)
}
API reference#
| Prop | Type | Default |
|---|---|---|
items | TimelineItem[] | SAMPLE_ITEMS |
className | string | - |
Examples#
Related dashboard components#
Account Setup ProgressReact onboarding card that shows account setup as completed steps out of a total, with a labelled progress bar and a hint for the next step to finish.Activity FeedReact activity feed that lists who did what and when, with initials avatars, muted action text and tabular timestamps in a single bordered card.Admin Stat StripResponsive Tailwind row of admin KPI tiles, each with a label, a large tabular value and an optional up or down delta. Collapses from four columns to one.Calendar AgendaReact agenda list of the day's events with a fixed time column, title and optional meta line such as location or attendees, divided inside one card.Goal RingA circular progress ring that shows how far along a goal is, with the percentage in the middle and a caption below. Handy for fitness, sales or weekly targets.Impersonation BannerA top of page bar telling support staff which user account they are viewing as, with an Exit button to end the session. Common in admin and support tools.
All dashboard components