Changelog
Changelog component: a heading over an ordered list of releases, the date in a narrow column on a thin rail and the entry beside it, heading and entries on one grid. Parts for the heading and lead, each release's title, paragraphs, a framed picture, labelled lists such as improvements and fixes, and authors.
The source comes with full access.
One payment of $149 opens the source right here and lets the CLI install every paid component, with lifetime updates.
Installation
pnpm dlx shadcn@latest add @01orbital/changelognpx shadcn@latest add @01orbital/changelogyarn dlx shadcn@latest add @01orbital/changelogbunx --bun shadcn@latest add @01orbital/changelogUsage
import {
Changelog,
ChangelogAuthors,
ChangelogContent,
ChangelogDate,
ChangelogDescription,
ChangelogEntries,
ChangelogEntry,
ChangelogGroup,
ChangelogGroupTitle,
ChangelogHeader,
ChangelogHeading,
ChangelogLead,
ChangelogList,
ChangelogMeta,
ChangelogTitle,
} from "@/components/changelog/changelog"
import {
Section,
SectionContent,
} from "@/components/section/section"
const COPY = {
title: "Changelog",
lead: "What changed, release by release.",
entries: [
{
date: "Nov 4, 2026",
dateTime: "2026-11-04",
title: "Saved views keep every filter where you left it",
body: "Name a filter, a sort and a layout together, and come back to it next week exactly as it was.",
groups: [
{
label: "Improvements",
items: [
"Recent searches follow you from one device to the next.",
"The sidebar remembers which sections you collapsed.",
],
},
{
label: "Fixes",
items: ["CSV exports keep leading zeros in ID columns."],
},
],
authors: "Ines Marlowe and Tomas Reyes",
},
{
date: "Oct 21, 2026",
dateTime: "2026-10-21",
title: "Search answers while you type",
body: "Results now arrive with each letter, so most searches end before the word does.",
authors: "Priya Nair",
},
],
} as const
export default function ChangelogDemo() {
return (
<Section>
<SectionContent size="lg">
<Changelog>
<ChangelogHeader>
<ChangelogHeading>{COPY.title}</ChangelogHeading>
<ChangelogLead>{COPY.lead}</ChangelogLead>
</ChangelogHeader>
<ChangelogEntries>
{COPY.entries.map((entry) => (
<ChangelogEntry key={entry.dateTime}>
<ChangelogMeta>
<ChangelogDate dateTime={entry.dateTime}>
{entry.date}
</ChangelogDate>
</ChangelogMeta>
<ChangelogContent>
<ChangelogTitle>
<a href="#">{entry.title}</a>
</ChangelogTitle>
<ChangelogDescription>{entry.body}</ChangelogDescription>
{"groups" in entry &&
entry.groups.map((group) => (
<ChangelogGroup key={group.label}>
<ChangelogGroupTitle>{group.label}</ChangelogGroupTitle>
<ChangelogList>
{group.items.map((item) => (
<li key={item}>{item}</li>
))}
</ChangelogList>
</ChangelogGroup>
))}
<ChangelogAuthors>{entry.authors}</ChangelogAuthors>
</ChangelogContent>
</ChangelogEntry>
))}
</ChangelogEntries>
</Changelog>
</SectionContent>
</Section>
)
}This example installs with everything it uses:
pnpm dlx shadcn@latest add @01orbital/changelog-demonpx shadcn@latest add @01orbital/changelog-demoyarn dlx shadcn@latest add @01orbital/changelog-demobunx --bun shadcn@latest add @01orbital/changelog-demoAnatomy
Changelog is built from 16 parts. In the example they nest like this:
Changelog
├─ ChangelogHeader
│ ├─ ChangelogHeading
│ └─ ChangelogLead
└─ ChangelogEntries
└─ ChangelogEntry
├─ ChangelogMeta
│ └─ ChangelogDate
└─ ChangelogContent
├─ ChangelogTitle
├─ ChangelogDescription
├─ ChangelogGroup
│ ├─ ChangelogGroupTitle
│ └─ ChangelogList
└─ ChangelogAuthorsChangelog: A changelog: a heading over an ordered list of releases, newest first. Put aChangelogHeaderfirst, thenChangelogEntrieswith aChangelogEntryinside for each release. The header and the entries share one column grid, so the heading lines up with the release titles.ChangelogHeader: The top of a changelog: put aChangelogHeadinginside, and aChangelogLeadunder it if you have one. It sits on the same columns as the entries, with its children in the content columns, so the heading lines up with the release titles. It leaves 64px before the entries, 80px from thelgbreakpoint.ChangelogHeading: The changelog's own heading, an<h2>by default in the display face: 30px, 40px from thesmbreakpoint. It takes the content columns, after the date column.ChangelogLead: A short introduction under the heading, in muted 16px text, in the same content columns. It leaves 16px above itself.ChangelogEntries: The releases, an ordered list. Put aChangelogEntryinside for each one.ChangelogEntry: One release, anli. Put aChangelogMetaand aChangelogContentinside it.ChangelogMeta: The narrow column beside a release: put aChangelogDateinside, and a version label above it if you have one. Its children stack 16px apart. In arailchangelog it starts 24px in from the line.ChangelogDate: The release date, as a<time>in 14px text. Give it adateTimevalue that machines can read.ChangelogContent: What the release says: put aChangelogTitlefirst, then any ofChangelogDescription,ChangelogMedia,ChangelogGroupandChangelogAuthors. Its children stack 20px apart.ChangelogTitle: The release's heading, an<h3>by default: 28px at weight 450 with tight tracking, 32px from thelgbreakpoint. A link inside turns muted while hovered.ChangelogDescription: A paragraph about the release, in muted 16px text. Use one for a short summary or several for a longer note; a<strong>inside reads at full strength.ChangelogGroup: A labelled list inside a release, such as "Improvements" or "Fixes": put aChangelogGroupTitleand aChangelogListinside, 32px apart. It leaves 32px above itself.ChangelogGroupTitle: The label over a group's list, an<h4>by default, in 24px text at weight 450.ChangelogList: The changes in a group, as a bulleted<ul>in muted 16px text. Put an<li>inside for each change; they sit 12px apart.ChangelogAuthors: Who made the release, in 14px text. An<img>placed directly inside shows as a 16px round avatar beside the names.ChangelogMedia: A picture or video for the release, in a 3:2 frame with a hairline edge. An<img>placed directly inside fills the frame and crops to it. It leaves 48px above and below, and none on the side where it comes first or last inChangelogContent.
API reference
Changelog
A changelog: a heading over an ordered list of releases, newest first. Put a ChangelogHeader first, then ChangelogEntries with a ChangelogEntry inside for each release. The header and the entries share one column grid, so the heading lines up with the release titles.
variant="rail" (the default) draws a thin line down the left edge of the entries from the sm breakpoint, with a short tick beside each date. variant="plain" has no line and no tick.
The tick and the top of the line sit --changelog-mark below the top of each entry: 23px, then 25px from the lg breakpoint, which centers them on a ChangelogDate beside a ChangelogTitle. Set the variable through className when something else comes first in ChangelogMeta.
Prop
Type
It also accepts the HTML attributes of the element it renders.
ChangelogHeader
The top of a changelog: put a ChangelogHeading inside, and a ChangelogLead under it if you have one. It sits on the same columns as the entries, with its children in the content columns, so the heading lines up with the release titles. It leaves 64px before the entries, 80px from the lg breakpoint.
It accepts the HTML attributes of the element it renders.
ChangelogHeading
The changelog's own heading, an <h2> by default in the display face: 30px, 40px from the sm breakpoint. It takes the content columns, after the date column.
Pass render to use another heading level.
It accepts the props of the Base UI part it wraps, and the HTML attributes of the element it renders.
ChangelogLead
A short introduction under the heading, in muted 16px text, in the same content columns. It leaves 16px above itself.
It accepts the HTML attributes of the element it renders.
ChangelogEntries
The releases, an ordered list. Put a ChangelogEntry inside for each one.
It accepts the HTML attributes of the element it renders.
ChangelogEntry
One release, an li. Put a ChangelogMeta and a ChangelogContent inside it.
Below the sm breakpoint the two stack, 8px apart. From sm they sit side by side on four columns with a 24px gutter, one for the meta and three for the content; from lg on eight columns, two and six. The first line of the meta lines up with the first line of the content, so a date sits level with the title. When a ChangelogMedia comes first in the content, the two align at the top instead.
Each entry leaves 112px before the next, and none after the last.
It accepts the HTML attributes of the element it renders.
ChangelogMeta
The narrow column beside a release: put a ChangelogDate inside, and a version label above it if you have one. Its children stack 16px apart. In a rail changelog it starts 24px in from the line.
It accepts the HTML attributes of the element it renders.
ChangelogDate
The release date, as a <time> in 14px text. Give it a dateTime value that machines can read.
It accepts the HTML attributes of the element it renders.
ChangelogContent
What the release says: put a ChangelogTitle first, then any of ChangelogDescription, ChangelogMedia, ChangelogGroup and ChangelogAuthors. Its children stack 20px apart.
It accepts the HTML attributes of the element it renders.
ChangelogTitle
The release's heading, an <h3> by default: 28px at weight 450 with tight tracking, 32px from the lg breakpoint. A link inside turns muted while hovered.
Pass render to use another heading level.
It accepts the props of the Base UI part it wraps, and the HTML attributes of the element it renders.
ChangelogDescription
A paragraph about the release, in muted 16px text. Use one for a short summary or several for a longer note; a <strong> inside reads at full strength.
It accepts the HTML attributes of the element it renders.
ChangelogGroup
A labelled list inside a release, such as "Improvements" or "Fixes": put a ChangelogGroupTitle and a ChangelogList inside, 32px apart. It leaves 32px above itself.
It accepts the HTML attributes of the element it renders.
ChangelogGroupTitle
The label over a group's list, an <h4> by default, in 24px text at weight 450.
Pass render to use another heading level.
It accepts the props of the Base UI part it wraps, and the HTML attributes of the element it renders.
ChangelogList
The changes in a group, as a bulleted <ul> in muted 16px text. Put an <li> inside for each change; they sit 12px apart.
Pass render={<ol />} with className="list-decimal" for numbered steps.
It accepts the props of the Base UI part it wraps, and the HTML attributes of the element it renders.
ChangelogAuthors
Who made the release, in 14px text. An <img> placed directly inside shows as a 16px round avatar beside the names.
It accepts the HTML attributes of the element it renders.
ChangelogMedia
A picture or video for the release, in a 3:2 frame with a hairline edge. An <img> placed directly inside fills the frame and crops to it. It leaves 48px above and below, and none on the side where it comes first or last in ChangelogContent.
It accepts the HTML attributes of the element it renders.
Dependencies
npm: @base-ui/react, cn. The CLI installs them for you.
Requires these pieces. The CLI adds each one that is missing and won't replace a file you already have unless you choose to:
font-hanken-grotesk
Used in blocks
2 blocks are built with Changelog:
Last updated on