A vertical list of events in chronological order.
$ pnpm dlx shadcn@latest add https://dashral.com/r/timeline.jsonInstallation
$ pnpm dlx shadcn@latest add https://dashral.com/r/timeline.jsonAdds the component, the components it builds on, its npm packages and the theme tokens it uses. Using Dashral often? Add the registry to components.json once:
components.json
{
"registries": {
"@dashral": "https://dashral.com/r/{name}.json"
}
}Then add components by name:
$ pnpm dlx shadcn@latest add @dashral/timelineUsage
example.tsx
import { Timeline } from "@/components/dashral/timeline"
<Timeline
items={[
{ title: "Order placed", time: "Oct 20, 09:12", dateTime: "2026-10-20T09:12" },
{ title: "Shipped", time: "Oct 21, 14:30", dateTime: "2026-10-21T14:30" },
]}
/>Examples
API reference
Timeline
Also takes every prop of <ol>(opens in a new tab).
| Prop | Type | Default |
|---|---|---|
items | { title, description?, time?, dateTime?, icon?, color?, id? }[]The events, in order. Required. | — |
classNames | { item, marker, title, time, description }Classes for each part. | — |
className | stringExtra classes, merged with cn() so yours win. | — |
Accessibility
- An ordered list; time goes in a <time> element, with dateTime for machines.