Changelog design polish: labeled badges, de-duplicated dates and titles, compact hero by vanrensbird · Pull Request #8031 · prisma/web

vanrensbird · 2026-07-07T14:11:28Z

What

Design and consistency pass on the changelog pages and the 2026 backfill entries, reviewed live against a local run of this branch.

Page code (`apps/site/src/app/changelog/`)

Change-type labels (New, Improved, Fixed, Breaking, Deprecated) render as subtle badges: once per highlight heading, and once per group in bullet lists instead of bold text repeated on every line. Lists without labels are untouched.
The version badge is hidden when it just repeats the entry date (this changelog sets version to the date). Real version labels like v7.5.0 still show.
Older/newer navigation at the bottom of each entry.
The index hero is left-aligned and uses the blog-article hero type scale, so entries start above the fold; the eyebrow moved to foreground-ppg-strong to pass WCAG AA (was 2.49:1).
Entry header spacing opened up; TOC titles no longer show raw label prefixes.

Content (`apps/site/content/changelog/`)

Removed the body-leading H2 that duplicated the frontmatter title on 49 entries (it rendered the title twice and polluted the TOC).
Every product section in the 2026 backfill entries now opens with a one-line summary derived from its items (previously only 2 of 16 had one).
Change-type labels moved to the front of highlight headings.
Emoji conventions replaced with text: 📚 links became *Read more:*, ℹ️ **Note:** became **Note:**.

Notes for reviewers

pnpm --filter site types:check passes.
The label-badge and section-summary conventions diverge from the generator skill in prisma/ignite#162; if this lands, the skill's mdx-structure.md/voice.md should be updated to match so future generated entries stay consistent.

🤖 Generated with Claude Code

Summary by CodeRabbit

New Features
- Changelog pages now show clearer release labels and badges, with improved grouping for labeled items.
- Release note headers and navigation have been updated for easier browsing between newer and older entries.
Bug Fixes
- Removed duplicate or redundant headings from many changelog entries.
- Fixed release note pages so content starts more cleanly and avoids repeated version titles.
- Improved list and heading rendering in changelog posts for more consistent formatting.

- Render leading New/Improved/etc labels in highlight headings and grouped bullet lists as subtle badges instead of repeated bold text - Hide the version badge when it duplicates the entry date - Add older/newer navigation at the bottom of each entry - Left-align and shrink the index hero to the blog-article type scale; fix the eyebrow contrast (2.49:1 -> AA) - Strip change-type labels from TOC item titles Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

- Remove the body-leading H2 that duplicated the frontmatter title (49 entries) - Give every product section a one-line summary (2026 backfill entries) - Move change-type labels to the front of highlight headings - Replace emoji conventions with plain text (Read more:, Note:) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

vercel · 2026-07-07T14:11:32Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
blog	Ready	Preview, Comment	Jul 7, 2026 2:13pm
docs	Ready	Preview, Comment	Jul 7, 2026 2:13pm
eclipse	Ready	Preview, Comment	Jul 7, 2026 2:13pm
site	Ready	Preview, Comment	Jul 7, 2026 2:13pm

coderabbitai · 2026-07-07T14:13:46Z

Walkthrough

This PR removes duplicated in-body headings from dozens of historic changelog MDX files (2024–2026) so content starts directly after frontmatter, updates content/formatting in several recent 2026 entries, and enhances the changelog slug/listing pages with change-label badge rendering and version-label suppression logic.

Changes

Changelog content cleanup

Layer / File(s)	Summary
Duplicate heading removal (2024–2026) `apps/site/content/changelog/2024-03-13.mdx` ... `2026-04-07.mdx`	Removes redundant top-level headings duplicating frontmatter titles across dozens of dated MDX changelog entries so body content begins directly after frontmatter.
Recent entry content/formatting updates `apps/site/content/changelog/2026-04-22.mdx` ... `2026-07-03.mdx`	Reorganizes Highlights sections, adds descriptive lines for Prisma ORM/Studio/Compute/Next, and standardizes note and "Read more" link formatting across several recent 2026 entries.

Changelog UI updates

Layer / File(s)	Summary
Slug page label badges and navigation `apps/site/src/app/changelog/[...slug]/page.tsx`	Adds utilities to parse and strip change-label prefixes, wraps MDX `h3`/`ul` rendering with badge components, computes label-stripped TOC and older/newer navigation, and updates header meta rendering.
Listing page hero and version label `apps/site/src/app/changelog/page.tsx`	Updates hero layout/typography and adds `versionLabel` logic that suppresses the version badge when it duplicates the entry date.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Possibly related PRs

prisma/web#7735: Builds directly on the same changelog slug/listing page badge, TOC, and version-label rendering logic modified in this PR.

Poem

A rabbit hopped through changelogs old,
Snipping duplicate headings, bold,
Then dressed each badge in tidy hue,
"New," "Improved," and "Fixed" too.
Version labels quietly hushed —
a cleaner changelog, freshly brushed. 🐇

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately summarizes the main changelog polish work: labeled badges, duplicate date/title cleanup, and a more compact hero.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

argos-ci · 2026-07-07T14:14:41Z

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build	Status	Details	Updated (UTC)
default (Inspect)	✅ No changes detected	-	Jul 7, 2026, 2:20 PM

coderabbitai

🧹 Nitpick comments (1)

apps/site/src/app/changelog/[...slug]/page.tsx (1)
165-170: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Consider hoisting the duplicated versionLabel rule into changelog-source.

This exact "hide version when it equals the date" computation (comment included) is repeated verbatim on the listing page (page.tsx, lines 53–59). Two copies of the same date-normalization rule tend to drift — if the date format or comparison ever changes, one side gets forgotten. A tiny shared helper, e.g. getVersionLabel(entry), keeps the invariant in one place.
♻️ Sketch of a shared helper
// changelog-source.ts
export function getVersionLabel(data: { date?: string; version?: string }) {
  return data.date &&
    data.version === new Date(data.date).toISOString().slice(0, 10)
    ? null
    : data.version;
}
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@apps/site/src/app/changelog/`[...slug]/page.tsx around lines 165 - 170, The
`versionLabel` hide-when-equal-to-date rule is duplicated in `page.tsx`, so move
that normalization into a shared helper in `changelog-source` (for example,
`getVersionLabel(entry)`), then call it from both the listing and detail page
paths. Keep the existing date-versus-version comparison logic in one place so
`page.tsx` and any other changelog consumers reuse the same source of truth.

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In `@apps/site/src/app/changelog/`[...slug]/page.tsx:
- Around line 165-170: The `versionLabel` hide-when-equal-to-date rule is
duplicated in `page.tsx`, so move that normalization into a shared helper in
`changelog-source` (for example, `getVersionLabel(entry)`), then call it from
both the listing and detail page paths. Keep the existing date-versus-version
comparison logic in one place so `page.tsx` and any other changelog consumers
reuse the same source of truth.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 196467a5-8748-4664-bd5b-aa0df73251a9

📥 Commits

Reviewing files that changed from the base of the PR and between 01d54ac and e56e14e.

📒 Files selected for processing (51)

apps/site/content/changelog/2024-03-13.mdx
apps/site/content/changelog/2024-04-03.mdx
apps/site/content/changelog/2024-04-25.mdx
apps/site/content/changelog/2024-05-15.mdx
apps/site/content/changelog/2024-06-06.mdx
apps/site/content/changelog/2024-06-27.mdx
apps/site/content/changelog/2024-07-18.mdx
apps/site/content/changelog/2024-08-08.mdx
apps/site/content/changelog/2024-08-29.mdx
apps/site/content/changelog/2024-09-26.mdx
apps/site/content/changelog/2024-10-17.mdx
apps/site/content/changelog/2024-11-07.mdx
apps/site/content/changelog/2024-11-28.mdx
apps/site/content/changelog/2024-12-19.mdx
apps/site/content/changelog/2025-01-09.mdx
apps/site/content/changelog/2025-01-30.mdx
apps/site/content/changelog/2025-02-20.mdx
apps/site/content/changelog/2025-03-13.mdx
apps/site/content/changelog/2025-04-10.mdx
apps/site/content/changelog/2025-05-01.mdx
apps/site/content/changelog/2025-05-19.mdx
apps/site/content/changelog/2025-06-05.mdx
apps/site/content/changelog/2025-06-17.mdx
apps/site/content/changelog/2025-07-02.mdx
apps/site/content/changelog/2025-07-17.mdx
apps/site/content/changelog/2025-07-30.mdx
apps/site/content/changelog/2025-08-27.mdx
apps/site/content/changelog/2025-09-10.mdx
apps/site/content/changelog/2025-10-08.mdx
apps/site/content/changelog/2025-11-05.mdx
apps/site/content/changelog/2025-11-19.mdx
apps/site/content/changelog/2025-12-03.mdx
apps/site/content/changelog/2025-12-17.mdx
apps/site/content/changelog/2026-01-21.mdx
apps/site/content/changelog/2026-02-11.mdx
apps/site/content/changelog/2026-02-19.mdx
apps/site/content/changelog/2026-02-27.mdx
apps/site/content/changelog/2026-03-11.mdx
apps/site/content/changelog/2026-03-27.mdx
apps/site/content/changelog/2026-04-07.mdx
apps/site/content/changelog/2026-04-22.mdx
apps/site/content/changelog/2026-04-27.mdx
apps/site/content/changelog/2026-05-15.mdx
apps/site/content/changelog/2026-05-19.mdx
apps/site/content/changelog/2026-06-05.mdx
apps/site/content/changelog/2026-06-11.mdx
apps/site/content/changelog/2026-06-19.mdx
apps/site/content/changelog/2026-06-24.mdx
apps/site/content/changelog/2026-07-03.mdx
apps/site/src/app/changelog/[...slug]/page.tsx
apps/site/src/app/changelog/page.tsx

💤 Files with no reviewable changes (40)

apps/site/content/changelog/2024-11-28.mdx
apps/site/content/changelog/2024-08-29.mdx
apps/site/content/changelog/2025-06-05.mdx
apps/site/content/changelog/2026-03-27.mdx
apps/site/content/changelog/2024-06-27.mdx
apps/site/content/changelog/2024-10-17.mdx
apps/site/content/changelog/2025-12-17.mdx
apps/site/content/changelog/2025-01-30.mdx
apps/site/content/changelog/2025-03-13.mdx
apps/site/content/changelog/2025-11-05.mdx
apps/site/content/changelog/2024-06-06.mdx
apps/site/content/changelog/2025-08-27.mdx
apps/site/content/changelog/2025-04-10.mdx
apps/site/content/changelog/2025-09-10.mdx
apps/site/content/changelog/2024-11-07.mdx
apps/site/content/changelog/2024-09-26.mdx
apps/site/content/changelog/2026-02-19.mdx
apps/site/content/changelog/2024-12-19.mdx
apps/site/content/changelog/2025-10-08.mdx
apps/site/content/changelog/2025-05-19.mdx
apps/site/content/changelog/2026-02-11.mdx
apps/site/content/changelog/2026-01-21.mdx
apps/site/content/changelog/2024-07-18.mdx
apps/site/content/changelog/2026-03-11.mdx
apps/site/content/changelog/2026-04-07.mdx
apps/site/content/changelog/2024-04-25.mdx
apps/site/content/changelog/2024-04-03.mdx
apps/site/content/changelog/2025-07-02.mdx
apps/site/content/changelog/2025-07-30.mdx
apps/site/content/changelog/2024-03-13.mdx
apps/site/content/changelog/2025-11-19.mdx
apps/site/content/changelog/2025-01-09.mdx
apps/site/content/changelog/2024-05-15.mdx
apps/site/content/changelog/2024-08-08.mdx
apps/site/content/changelog/2025-02-20.mdx
apps/site/content/changelog/2025-07-17.mdx
apps/site/content/changelog/2025-06-17.mdx
apps/site/content/changelog/2025-12-03.mdx
apps/site/content/changelog/2026-02-27.mdx
apps/site/content/changelog/2025-05-01.mdx

vanrensbird and others added 2 commits July 7, 2026 16:11

vercel Bot deployed to Preview – blog July 7, 2026 14:12 View deployment

vercel Bot deployed to Preview – eclipse July 7, 2026 14:12 View deployment

vercel Bot deployed to Preview – site July 7, 2026 14:13 View deployment

vercel Bot deployed to Preview – docs July 7, 2026 14:13 View deployment

coderabbitai Bot reviewed Jul 7, 2026

View reviewed changes

ankur-arch merged commit ce8c228 into changelog/backfill-2026-q2 Jul 8, 2026
11 checks passed

ankur-arch deleted the changelog/design-polish branch July 8, 2026 13:51

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Changelog design polish: labeled badges, de-duplicated dates and titles, compact hero#8031

Changelog design polish: labeled badges, de-duplicated dates and titles, compact hero#8031
ankur-arch merged 2 commits into
changelog/backfill-2026-q2from
changelog/design-polish

vanrensbird commented Jul 7, 2026 •

edited by coderabbitai Bot

Loading

Uh oh!

vercel Bot commented Jul 7, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot commented Jul 7, 2026 •

edited

Loading

Uh oh!

argos-ci Bot commented Jul 7, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

vanrensbird commented Jul 7, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What

Page code (apps/site/src/app/changelog/)

Content (apps/site/content/changelog/)

Notes for reviewers

Summary by CodeRabbit

Uh oh!

vercel Bot commented Jul 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai Bot commented Jul 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Uh oh!

argos-ci Bot commented Jul 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

vanrensbird commented Jul 7, 2026 •

edited by coderabbitai Bot

Loading

Page code (`apps/site/src/app/changelog/`)

Content (`apps/site/content/changelog/`)

vercel Bot commented Jul 7, 2026 •

edited

Loading

coderabbitai Bot commented Jul 7, 2026 •

edited

Loading

argos-ci Bot commented Jul 7, 2026 •

edited

Loading