Overview

Changelog entries are MDX files under content/changelog. Each entry has a version, title, description (rich text), date, and optional tags. Entries are rendered together on /changelog with search and tag filters.

Location and slug

  • Collection: changelog
  • Path: content/changelog
  • Filename: read-only; generated as v<version>-<slugified-title>

Use semantic versions when possible (e.g., 1.2.3). The filename is built automatically from version and title.

Fields

  • version — required (string).
  • title — required (string).
  • description — required (rich text).
  • createdAt — required date; used for sorting and “time ago” display.
  • tags — optional list using predefined options.

Tags

Available tags: Bug Fix, Improvement, New Feature. Update options in tina/options/changelogTags.ts if you need more.

Listing page

  • Route metadata is defined in app/changelog/page.tsx.
  • Data is loaded via fetchChangelog(last = 50) which queries the Tina connection, sorts by createdAt, and returns parsed entries.
  • The UI (<ChangelogOverview />) supports search and tag filtering, and shows version, date, rich text description, and badges for tags.

There are no per-entry routes (no /changelog/[slug]). All entries appear on a single page.

Guidelines

  • Use clear, human-friendly titles per release.
  • Keep description concise; group related changes into bullets.
  • Set an accurate date (createdAt)—the list and “time ago” rely on it.
  • Add tags for quick scanning and filtering.
  • Prefer semantic versioning (e.g., 1.4.0).