Changelog, timeline


Install
npx shadcn add https://ui.klarhimmel.com/r/changelog-timeline.jsonDetailsAbout, usage, props and more
A changelog as a vertical timeline: each entry has a date (with an optional version), a title, a paragraph, tags in words and a short list of changes.
Import
Import
- changelog/timeline
- About
- A changelog as a vertical timeline: each entry has a date (with an optional version), a title, a paragraph, tags in words and a short list of changes. Entries are articles with the date as a time heading.
- Category
- What changed and when: dated entries with tags, or a compact list. New project? Set it up once: /get-started/installation.
Notes
When to use it
A release history told as a vertical timeline, for a changelog page where each change deserves a paragraph. For a short what-is-new strip, changelog-compact is lighter.
Writing for it
- Each entry takes a date written as you want it shown, an optional version of 12 characters, a body of 300 and up to five bullet changes. Newest first reads best. - Tags are words such as New or Fix, up to three per entry. They are never colour alone, so keep them to one word. - The block holds two to six entries. Link the rest through the closing link instead of adding a long tail here.
Watch out for
Every entry is an article with its date as a time heading. Dates are plain text, so keep one format across entries or the timeline reads as unsorted.
Pairs well with
Usage
The block in a page, with its default content (long lists shortened). Every prop is in the table below.
Props
The type, default and text limit of every prop. On a real page, over-limit text is kept and checkSections flags it (Installation, Check a page before you ship); this live preview shows the default until it fits. The panel above edits all props.
| Prop | Type | Default | Description |
|---|---|---|---|
eyebrow | string | 'Name the topic' | Text, up to 60 characters. |
title | string | 'Say what the list shows' | Text, up to 120 characters. |
description | string | 'Say in one or two sentences how the…' | Text, up to 300 characters. |
entries | { date, version, title, body, tags, changes }[] | 3 items | List of 2 to 6. Each item: date, version (optional), title, body, tags, changes. |
more | Link | {…} | See the type. |
headingLevel | '1' | '2' | - | One of '1', '2'. Optional; empty is not rendered. |