# Changelog list

> A list of releases. Each has a version, a date and its changes, labelled Added, Changed, Fixed, Removed, Deprecated or Security. Every release is its own article with a heading and an anchor.

Facade UI item `changelog-list` (block, section).
Docs page: https://facadeui.dev/components/changelog-list · Registry JSON: https://facadeui.dev/r/changelog-list.json

## Install

```bash
npx shadcn@latest add @facade/changelog-list
```

Or by URL: `npx shadcn@latest add https://facadeui.dev/r/changelog-list.json`. The CLI also installs what it needs: @facade/badge, @facade/container, @facade/heading, @facade/section, @facade/section-header, @facade/types, @facade/utils.

Files: `components/sections/changelog-list.tsx`

Usage example as an installable item: `npx shadcn@latest add @facade/changelog-list-demo` (lands in components/examples/).

## Usage

The source of the preview on the docs page. `./content` holds sample data.

```tsx
import { ChangelogList } from "@/components/sections/changelog-list"

import { RELEASES } from "./content"

export function Demo() {
  return (
    <ChangelogList
      eyebrow="Changelog"
      title="What shipped"
      description="Every release, newest first."
      items={RELEASES}
    />
  )
}
```

## Props

### ChangelogListProps

Extends SectionBaseProps, ListSlotProps.

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `items` (required) | `ChangelogEntry[]` |  |  |
| `title` | `string` |  |  |
| `eyebrow` | `string` |  |  |
| `description` | `string` |  |  |
| `link` | `LinkComponent` |  |  |
| `itemHeadingLevel` | `HeadingLevel` |  | Heading level of each release. Defaults to one below `headingLevel`. |
| `kindLabels` | `Partial<Record<ChangeKind, string>>` |  | Words for the change kinds, for translation. |
| `align` | `"start" \| "center"` | `"start"` |  |