Milestone Timeline, animated React component
A roadmap timeline. When it scrolls into view a glowing bead runs down the rail, drawing each finished milestone's check as it passes, overshoots the milestone in progress slightly and settles on it; clicking a milestone or using the arrow keys slides a raised card to it and opens its notes. Also includes Roadmap Scrubber, an edit-style timeline where you drag a playhead and every bar fills to that day. Also includes Commit Graph Roadmap, a roadmap drawn as git log --graph with release tags, branch lanes and a pulsing HEAD.
- Free
- Timelines
- Scroll
- Spring
Milestone Timeline
Roadmap Scrubber
Commit Graph Roadmap
Like Milestone Timeline? 256 more are in Pro.
Pro unlocks all 256 Pro components, every template and block, and everything we release next. Milestone Timeline stays free.
Play with it
Move the controls and watch it change. Copy code gives you a snippet with only the props you changed.
Roadmap
2 of 4 complete- Jan 2026
- Mar 2026
- Jun 2026
312 teams onboarded. Activation up 38% after the second iteration.
- Sep 2026
Props
| Prop | Type | Default | What it does |
|---|---|---|---|
| milestones | { title: string; date?: string; description?: string; status?: "done" | "current" | "upcoming"; tag?: string }[] | — | Roadmap milestones. |
| steps | string[] | — | Plain titles (older API); all but the last count as done. |
| heading | string | "Roadmap" | Heading. |
| defaultOpen | number | — | Milestone opened first; defaults to the current one. |
| autoplay | boolean | false | Opens each milestone in turn until someone touches the timeline. |
| className | string | — | Extra classes on the section. |
| RoadmapScrubber.tracks | RoadmapScrubberTrack[] | Design, Engineering and Launch sample for 2026 | Tracks to draw. Each has a name, bars with start and end dates, and milestone marks with a date. Dates are YYYY-MM-DD. |
| RoadmapScrubber.year | number | 2026 | The calendar year the chart spans, January to December. Dates outside it clamp to the edges. |
| RoadmapScrubber.today | string | "2026-06-15" | The date marked as today and the end point of the opening sweep. The component never reads the real clock, so it renders the same everywhere. |
| RoadmapScrubber.title | string | "Roadmap <year>" | Heading of the card. |
| RoadmapScrubber.autoplay | boolean | false | After the opening sweep, glides the playhead through the year and back to today until someone touches the chart. |
| RoadmapScrubber.className | string | "" | Extra classes for the card. |
| CommitGraphRoadmap.commits | RoadmapCommit[] | 8-commit sample roadmap | Commits, newest first. Each has a lane (0 main, 1 feature, 2 lab), a title, a meta line, a body, a state (done, head or next) and an optional release tag. |
| CommitGraphRoadmap.branches | RoadmapBranch[] | feature and lab lanes of the sample | Branch lanes that fork from main at row from and merge back at row to. Row 0 is the top. |
| CommitGraphRoadmap.defaultOpen | number | the HEAD row | Row whose commit message is open first. |
| CommitGraphRoadmap.autoplay | boolean | false | Opens each commit in turn once the graph is on screen, until someone touches it. |
| CommitGraphRoadmap.className | string | "" | Extra classes for the card. |
Add it to your project
- 1
Set up your project once
You need a Next.js project with Tailwind CSS and the
@/import alias. In its root folder, run this once. It createscomponents.jsonand thecn()helper insrc/lib/utils.ts:npx shadcn@latest init -d
Starting from nothing? The Quick Start walks through the whole thing.
- 2
Connect the registry
Run this once per project. It writes the Nexus UI entry into
components.jsonfor you:npx shadcn@latest registry add "@nexus-labs=https://www.nexus-ui.com/api/registry/{name}"Type it exactly as shown.
{name}is filled in by the CLI with the component you ask for, so you never replace it.
- 3
Add the component
Run this from your project root. It adds the component, the helpers it imports and its npm packages.
npx shadcn@latest add @nexus-labs/milestone-timeline
- 4
Check what was added
With a project made as in the Quick Start (a
src/folder), these files land in it:components/milestone-timeline/commit-graph-roadmap.tsxindex.tsmilestone-timeline.tsxroadmap-scrubber.tsx - 5
Copying by hand? Skip the registry
Instead of steps 2 and 3 you can copy the files yourself, with no registry and no API key. Step 1 still applies, so that
cn()exists. Install the packages:npm install framer-motion
Then show the source and create each file at the path it gives:
- 6
Use it in a page
Installing only adds the files. Import the component in a page and render it. The Usage tab on the preview shows a fuller example with props:
// src/app/page.tsx import { MilestoneTimeline } from "@/components/milestone-timeline"; export default function Page() { return ( <main> <MilestoneTimeline /> </main> ); }
Like Milestone Timeline? 256 more are in Pro.
Pro unlocks all 256 Pro components, every template and block, and everything we release next. Milestone Timeline stays free.
About Milestone Timeline
The Milestone Timeline is a vertical roadmap with animated glowing node points and scroll-triggered entrance effects. Each milestone node pulses with a soft outer glow on hover using Framer Motion. The connecting timeline line and nodes are styled with CSS custom properties for color customization. Scroll triggers animate each milestone into view with a stagger, rewarding visitors who read down the page. Best for product roadmaps, company history sections, and changelog displays.
Good for
- Product roadmap sections
- Company history and about pages
- Feature release timelines
- Project milestone and progress displays
Milestone Timeline questions
How do I add my own milestones?
Pass `milestones` as an array of `{ title, date, description, status, tag }`, where status is "done", "current" or "upcoming". For a quick list you can pass `steps` as plain strings instead; every step before the last is treated as done.
Is this an alternative to the Material UI Timeline?
It covers the same vertical timeline layout without MUI: it is a single Tailwind CSS component that only depends on framer-motion and lucide-react.
Does it support dark mode and reduced motion?
Yes. It ships with Tailwind `dark:` styles, and when the user prefers reduced motion the entrance animation and the pulsing ring on the current milestone are skipped.
How does it look on mobile?
Below the `sm` breakpoint the date column is hidden and each date moves inline next to its milestone title, so the timeline stays readable on narrow screens.