Skip to content
shadcn.io

shadcn.io is not affiliated with official shadcn/ui

Category Sections Changelog Block for React

A changelog for a file organiser grouped under Added, Improved and Fixed headings, with a sticky index of the three sections beside them and every change tagged with the release it shipped in.

Framework
UI library

Preview

Preview width

Installation

Part of Pro
Pro unlocks the code and one-line install of every Pro button and text effect, plus the MCP for your AI editor.
Have Pro already? Sign in to open it.Opens here as soon as you're Pro.

Overview

A changelog grouped by kind for React with Base UI, written for Sortshelf, a fictional file organiser. Behind a split divider the end column holds three sections, Added, Improved and Fixed, each a heading with an icon plate and a count over a ruled list of three changes; every change has a title, a sentence, and the version and day of the release it shipped in. In the start column the title and an index of the three sections stay in view while you read: a bar follows the section on screen, and each entry jumps to its heading and carries its count. On a phone the index becomes a row of chips under the title. The page's rails and top rule come from the Guides spine, so the block lines up with its neighbours in a stack. It's built from Guides, Toc and Button, with CSS transitions for the entrance and your theme's tokens for every colour. For product changelogs and release hubs where readers scan by kind of change rather than by date. The changes are example data.

FAQ

How do I add a change or a section?

Edit GROUPS at the top of the file. Each group has an anchor (the heading's id, which must be unique on the page), an icon, a label and its changes; each change has a title, a summary, a version and a date as an ISO day ("2026-03-24"). The index, its counts and the "9 changes" in the header are all computed from the same list, so a new group or change shows up everywhere at once. Dates are fixed and spelled out by a small helper, so they read the same on the server and in every browser.

How does the index work?

From lg it's the catalog Toc: it stays in view beside the sections, marks the section currently on screen with a bar, and each entry is a link to its heading. Below lg the same three links become a row of chips under the title, plain anchors without the moving bar. The sections are short, so on a tall screen they may all be in view at once; the bar then rests on the first.

Are the section icons emoji?

No. They are Lucide icons on a small plate (a sparkle for Added, a rising line for Improved, a wrench for Fixed), drawn in your theme's colours, so they match your type and read in any theme. The section's name is text in its heading.

How does it fit on a phone and in a right-to-left layout?

Below lg the columns stack: the title, the chip row, then the sections one under another, each ruled from rail to rail. Each change puts its version and day under the text. Nothing scrolls sideways at 320 pixels; the chip row scrolls if its chips ever outgrow the width. In a right-to-left layout the index, the split divider and the version column swap sides, the arrow on View all releases turns, and the counts and versions stay in reading order.

What moves, and what happens with reduced motion?

The header and the sections fade up once on load, and the index's bar slides between sections. With reduced motion both are off and the block simply appears. The block has no state of its own.

  • Pro

    Release Timeline Changelog

    Lists and timelines

    A release timeline for an API client: a compact header with a Subscribe link, then the latest four releases on a hairline rail with dots, each with its version, date, type tags, a linked title and its notes, and View all releases at the foot.

  • Pro

    Filterable Changelog

    Filters and browsing

    The plainest filtered release list: one row of choices with counts (All, New, Improved, Fixed, Security) over nine releases, a live count of what is showing, and a height that never changes.

  • Pro

    Grouped Date Changelog

    Lists and timelines

    Changes grouped by the day they shipped: each day has a drawn calendar tile (month, big day number, weekday) beside a dated heading and its changes with a type tag, a sentence and the release.

  • Pro

    Category Browser Changelog

    Filters and browsing

    A three-by-two browser of changelog topics: each cell has a drawn icon, the topic's name as its link, an entry count and its newest entry with version and date.

  • Pro

    Condensed Feed Changelog

    Lists and timelines

    Twelve releases of a news reader as a single-line ledger: the day, a type word, the headline and the version on one row, month rows between, and the older rows opening in place.

  • Pro

    Compact Badges Changelog

    Lists and timelines

    The eight latest releases of a ticketing tool as one dense framed table: a mono version badge, a type tag with an icon and a word, what changed and the day it shipped.