Milestone Changelog Timeline
A vertical timeline of milestone releases connected by a continuous line, each with a dot marker, a version badge and date, an optional title, and a list of changes tagged with tone-coded badges (Added, Changed, Fixed, Removed).
Docs
Installation
A real shadcn registry command, not a copy-paste stand-in: it fetches this block plus its badge dependencies and any missing npm packages, and installs them straight into your project.
npx shadcn add https://staaarter.com/r/milestone-changelog-timeline.jsonPrefer not to use the CLI? Copy the source from the Code toggle above into src/components/blocks/changelog/changelog5.tsx instead.
Usage
The file also exports changelog5Demo, the exact props behind the preview above. Spread it to get a working section in one line, then replace it with your own data.
import { Changelog5, changelog5Demo } from "@/components/blocks/changelog/changelog5"; export default function Page() { return <Changelog5 {...changelog5Demo} />; }
Props
| Prop | Type | Default | Description |
|---|---|---|---|
| heading | string | "Product timeline" | Section heading. |
| description | string | none | Section intro text. |
| releases | TimelineRelease[] | none | Milestone releases, rendered in array order along the timeline. |
| className | string | none | Extra classes for the outer section element. |
Types
type ChangeType = "added" | "changed" | "fixed" | "removed"; type ChangeLine = { type: ChangeType; text: string }; type TimelineRelease = { version: string; date: string; title?: string; changes: ChangeLine[]; };
Behavior notes
- The connecting line and dot markers are pure CSS (a border-l-2 rail plus an absolutely positioned dot per <li>), not an image or canvas draw, so it renders identically at build time and in the static thumbnail.
- Change-type badges follow this category's shared tone convention: Added uses variant "default", Changed uses "secondary", Fixed uses "outline", and Removed uses "destructive".
- date is a plain display string set by the caller, never computed at render time.
- title is optional per release; when omitted, the entry shows only the version badge, date, and change list.
More Changelog Blocks
View all →split-milestone-changelog
Split Milestone Changelog
Two-column release entries pairing milestone context with highlights and metrics.
changelog-release-feed
Changelog Release Feed
Release feed cards with aligned change-type labels and an optional CTA per card.
grouped-changelog-board
Grouped Changelog Board
Releases grouped under bold month headings with aligned version and description columns.
minimal-text-changelog
Minimal Text Changelog
Ultra-plain, text-only changelog with no badges, cards, or borders.
categorized-release-notes
Categorized Release Notes
Per-release changes grouped into Added, Changed, and Fixed sub-sections.
featured-release-changelog
Featured Release Changelog
The latest release highlighted in a large featured card, older releases condensed below.