Staaarter

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

By Staaarter Team
Changelog
Docs
Live preview

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

Prefer 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

PropTypeDefaultDescription
headingstring"Product timeline"Section heading.
descriptionstringnoneSection intro text.
releasesTimelineRelease[]noneMilestone releases, rendered in array order along the timeline.
classNamestringnoneExtra 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.