Skip to content

MarketingLumen Halo

ChangelogProv1.0.0

Release notes as a dated feed on a quiet rail. Filter by New, Improved or Fixed and the months with nothing left fold away; each release shows its headline and summary and opens in place to its full list of changes, while the month you're reading stays pinned.

.md
pnpm dlx shadcn@latest add @beautiful-ui-pro/lumen-changelog

Needs your registry key. Your components.json style picks the Base UI or Radix build: radix-*, new-york and default get Radix, base-* gets Base UI.

Styles didn't apply?

The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.

Set up the Beautiful UI registry

Free pieces install from their URL with no setup (that URL gives the Base UI build; Radix projects use /r/radix-nova/<name>.json, or add the registries below and the CLI picks your build). Pro pieces need the registries below and BEAUTIFUL_UI_TOKEN in .env.local.

components.json
{
  "registries": {
    "@beautiful-ui": "https://beautiful-ui.dev/r/{style}/{name}.json",
    "@beautiful-ui-pro": {
      "url": "https://beautiful-ui.dev/r/pro/{style}/{name}.json",
      "headers": { "Authorization": "Bearer ${BEAUTIFUL_UI_TOKEN}" }
    }
  }
}

MCP server

claude mcp add --transport http beautiful-ui https://beautiful-ui.dev/api/mcp
Catalog for agents: /llms.txt

Usage

Import it and pass your content. The props that matter most are listed next.

Example
import { Changelog, type ChangelogEntry } from "@/components/ui/lumen/blocks/changelog";

const releases: ChangelogEntry[] = [
  {
    id: "r42",
    date: "2026-09-28",
    version: "4.2",
    title: "Saved views for every table",
    summary: "Save a filter and sort, share it with your team and set it as the default.",
    changes: [
      { kind: "new", text: "Saved views on every data table" },
      { kind: "improved", text: "Filters open twice as fast on large tables" },
      { kind: "fixed", text: "Date filters now respect your time zone" },
    ],
    href: "/blog/saved-views",
  },
];

export function WhatsNew() {
  return <Changelog entries={releases} />;
}

Props

  • entries–

    ChangelogEntry[]

    ChangelogEntry = { id, date (ISO), title, summary?, version?, changes?: { kind: "new" | "improved" | "fixed", text }[], href? }. Any order; shown newest first.

  • filter / defaultFilter / onFilterChange"all"

    "all" | "new" | "improved" | "fixed"

    Which kind of change to show, controlled or not.

  • defaultOpenthe newest

    string[]

    Entries open at first.

  • locale"en-US"

    string

    How dates are written.

  • labels–

    Partial<ChangelogLabels>

    Every word, for i18n.

Source

components/ui/lumen/blocks/changelog.tsx

This component is included with Pro.

Try the live preview above. Get Pro to install the source.