Skip to content
shadcn.io

shadcn.io is not affiliated with official shadcn/ui

Numbered List Changelog Block for React

A ladder of the five latest releases of a habit app: a short header beside a divider, and large ordinals 01 to 05 with a hairline between each number and its version, tag, title, sentence and date.

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 numbered changelog for React with Base UI, written for Stepcount, a fictional habit tracker. At the start of a split sits a short header with the title and one sentence; at the end of a divider that reaches the top rule is a ladder of five rungs ruled from the divider to the rail. Each rung has a large tabular ordinal in a start column (01 for the newest release, down to 05), a hairline between the number and the text, then the version in mono, a type tag with an icon and a word (New, Improved, Fixed, Security), the day it shipped at the end, a title and one line. The ordinal is decoration: the list is ordered, so assistive technology already announces each position. On a phone the number sits above its text and a rule runs between the header and the ladder. The page's rails and top rule come from the Guides spine, so it lines up with its neighbours in a stack. It's built from Guides and Badge, with CSS transitions for the entrance and your theme's tokens for every colour. For product changelogs that want the latest releases read as steps. The releases are example data.

FAQ

How do I change the releases?

Edit RELEASES at the top of the file, newest first. Each release has an ordinal (the text on the ladder, "01" to "05"), a version, a date as an ISO day ("2026-09-18"), a kind, a title and a one-sentence summary. The date on screen is spelled out from the ISO day by a small helper, so it reads the same on the server and in every browser. Dates are fixed, never computed from today. Keep it to five rungs: older releases belong behind a link to the full list.

What do the numbers mean, and does a screen reader hear them?

They are positions on the ladder, not versions: 01 is the newest release and 05 the oldest of the five. They are hidden from assistive technology because the list is an ordered list, so a screen reader already says "1 of 5" and so on. The version, which does carry meaning, is real text on each rung.

How are the change types told apart without colour?

Each type tag is an outline badge with an icon and the word, so it reads in greyscale, in any theme and to a screen reader, which hears the word and skips the icon. The kinds are constants at the top of the file; add one by adding one more.

How does the split work on a phone?

Below lg the header comes first, a rule runs under it, and each rung stacks its number above its text. The vertical hairline between the number and the text, and the divider between the header and the ladder, appear from lg up. Nothing scrolls sideways at 320 pixels, and in a right-to-left layout the ladder moves to the left and the numbers sit on the right.

What moves, and what happens with reduced motion?

The header and the ladder fade up once on load, with CSS transitions. With reduced motion they are off and the block simply appears. The block has no state.

  • 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

    Compact Timeline Changelog

    Lists and timelines

    The last three weeks of a time-tracking app on one thin rail: six releases of two small lines each, with the dot's shape (circle, diamond, square, ring) telling the kind and a one-line key.

  • Pro

    Milestone Markers Changelog

    Lists and timelines

    A centred rail for a build service: milestones are filled diamonds with their version, day and kind on one side and their title on the other, patches are small dots in a compact line, and a toggle shows milestones only or every release.

  • Pro

    A release banner for a release-management tool: the latest version set large at the start, and the three before it as a numbered list at the end, split by a solid divider.

  • Pro

    Release Notes Changelog

    Spotlights and media

    One release written as a long article behind a split divider, with a sticky contents list that marks the section on screen and turns into a row of chips on a phone.

  • Pro

    Stacked Cards Changelog

    Spotlights and media

    A deck of the three latest releases of a notes app: the top card in full, the two behind it peeking out, and a Next release button that sends the top card to the back.