Timeline
A changelog, a contract's history or a roadmap as an ordered list with real <time> dates. Dates in a column, above each entry, or entries either side of a centre line; tones and icons on the dots; sticky dates for long entries.
The decision inside it
The beam is your scroll, not a timer
It is exactly as far down as you have read. It is decoration, hidden from screen readers, and drawn full with reduced motion.
When to use it
Use Timeline for events in order with dates: a contract's history, a changelog, a company story. compact suits a sidebar; alternate suits a page. For steps someone still has to finish, use a stepper.
Installation
How you get it
Paste this into Claude Code, Cursor, Codex or any coding agent. It installs the file and uses it as it is, instead of writing a new one.
Use Layro's Timeline for this.
Install it: npx shadcn@latest add @layro/timeline
(the @layro registry is set up in components.json, with LAYRO_KEY in .env.local)
Import it from @/components/ui/timeline.
Do not rewrite or restyle it. Pass my data through its props
and keep its built-in states.For the full brief with every prop and the mistakes assistants usually make, use Copy prompt above. Free components install through the @layro registry with your CLI token: see the Namespaced tab.
Usage
import { Timeline } from "@/components/ui/timeline";
export function ContractHistory() {
return (
<Timeline
variant="compact"
items={[
{ id: "1", date: "Mar 3", title: "Sent to Vertically" },
{ id: "2", date: "Mar 4", title: "Viewed by Olivia Martinez" },
{ id: "3", date: "Mar 4", title: "Signed", tone: "success" },
]}
/>
);
}API reference
“Copy prompt” above puts a full brief on your clipboard — install command, dependencies, props, and the mistakes an assistant usually makes with this component.
Props
Read from the component’s own TypeScript interface when the site is built, so this table cannot drift from the file you install.
| Prop | Type | Notes |
|---|---|---|
itemsrequired | TimelineItem[] | — |
variant | "default" | "compact" | "alternate" | "default" puts dates in a column, "compact" above each title, "alternate" either side of a centre line. Default "default". |
stickyDates | boolean | Keep each date in view while its content scrolls. Default false. |
scrollBeam | boolean | Fill the line as the reader scrolls. Default false. |
Dependencies
npm packages
clsxframer-motiontailwind-mergeLayro foundations, installed alongside it
layro-themeStates
All of them are drawn by the component. None is left for you to design.
- Default
- Compact
- Alternate
- Scroll beam
- Sticky dates
Accessibility
- Keyboard reachable throughout, in visual order
- Focus trapped in overlays, Escape closes them
- Focus returns to whatever opened it
- Live regions announce what changed, not that something did
- Honours prefers-reduced-motion
Responsive behavior
- Sizes to its container, not the viewport
- Usable from 320px up
- Pointer-based interaction, so trackpad and touch both work
- No hover-only affordances
Lifetime access
Every component, and everything we ship next.
- All 232 components, source included
- Every template, and everything released after you buy
- shadcn CLI or download — React 18/19, Tailwind v4
- One payment. No subscription.
More in Data & feedbackAll Data & feedback components
Carousel
Slides you swipe, drag, click or arrow through, one or several at a time.
Swipe to Delete
A list row that slides aside to show its actions; swipe all the way to run the main one.
Infinite Scroll
A list that loads the next page as the reader nears its end, with loading, end and error states.
Stacked Cards
Notifications or tips piled one behind another that fan out into a list on hover or focus.
Image Compare
Two pictures one over the other with a handle to wipe between them: before and after.
Data Table
TanStack table with sorting, search, row selection, bulk actions, column toggle and pagination.