Skip to content

NewMCP server for your coding agent. Set it up ›

Nexus UI
Get Pro

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
  1. 312 teams onboarded. Activation up 38% after the second iteration.

Props

PropTypeDefaultWhat it does
milestones—Roadmap milestones.
steps—Plain titles (older API); all but the last count as done.
heading"Roadmap"Heading.
defaultOpen—Milestone opened first; defaults to the current one.
autoplayfalseOpens each milestone in turn until someone touches the timeline.
className—Extra classes on the section.
RoadmapScrubber.tracksDesign, Engineering and Launch sample for 2026Tracks to draw. Each has a name, bars with start and end dates, and milestone marks with a date. Dates are YYYY-MM-DD.
RoadmapScrubber.year2026The calendar year the chart spans, January to December. Dates outside it clamp to the edges.
RoadmapScrubber.today"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"Roadmap <year>"Heading of the card.
RoadmapScrubber.autoplayfalseAfter the opening sweep, glides the playhead through the year and back to today until someone touches the chart.
RoadmapScrubber.className""Extra classes for the card.
CommitGraphRoadmap.commits8-commit sample roadmapCommits, 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.branchesfeature and lab lanes of the sampleBranch lanes that fork from main at row from and merge back at row to. Row 0 is the top.
CommitGraphRoadmap.defaultOpenthe HEAD rowRow whose commit message is open first.
CommitGraphRoadmap.autoplayfalseOpens each commit in turn once the graph is on screen, until someone touches it.
CommitGraphRoadmap.className""Extra classes for the card.

Add it to your project

  1. 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 creates components.json and the cn() helper in src/lib/utils.ts:

    npx shadcn@latest init -d

    Starting from nothing? The Quick Start walks through the whole thing.

  2. 2

    Connect the registry

    Run this once per project. It writes the Nexus UI entry into components.json for 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.

  1. 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
  2. 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.tsx
    index.ts
    milestone-timeline.tsx
    roadmap-scrubber.tsx
  3. 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:

  4. 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.

Guides