Changelog

Open source

Changelog / release-notes sections — a version-rail timeline, a card grid, and a date-rail timeline with per-entry media.

Add to page builder

2 of 3

resources/views/blocks/changelog-cards.blade.php Blade

@props([
    'heading'        => 'What\'s new',
    'lead'           => 'Every release, shipped to your inbox before it hits the docs.',
    'subscribeLabel' => 'Subscribe to updates',
    'subscribeHref'  => '#',
    'releases'       => null,
])

@php
    $releases ??= [
        ['version' => 'v2.5.0', 'date' => '2026-06-10', 'dateLabel' => 'Jun 10, 2026', 'category' => 'Added', 'variant' => 'success', 'title' => 'Changelog card-grid layout', 'body' => 'A responsive three-column grid variant — each release lives in its own card with version, category, and change count.', 'changes' => 6],
        ['version' => 'v2.4.1', 'date' => '2026-05-28', 'dateLabel' => 'May 28, 2026', 'category' => 'Fixed', 'variant' => 'destructive', 'title' => 'Badge contrast & RTL separator', 'body' => 'Destructive badge foreground now clears WCAG 2.2 AA contrast, and the separator renders on the correct logical side in RTL.', 'changes' => 3],
        ['version' => 'v2.4.0', 'date' => '2026-05-14', 'dateLabel' => 'May 14, 2026', 'category' => 'Added', 'variant' => 'success', 'title' => 'Dark-mode palette overhaul', 'body' => 'Muted and accent surfaces were re-mapped across the full token set for better legibility on dark backgrounds.', 'changes' => 8],
        ['version' => 'v2.3.0', 'date' => '2026-04-30', 'dateLabel' => 'Apr 30, 2026', 'category' => 'Improved', 'variant' => 'secondary', 'title' => 'Badge size scale expansion', 'body' => 'Badge gains an expanded size scale via the shared styles map so consumers no longer need bespoke overrides.', 'changes' => 4],
        ['version' => 'v2.2.0', 'date' => '2026-04-10', 'dateLabel' => 'Apr 10, 2026', 'category' => 'Added', 'variant' => 'success', 'title' => 'Registry bundle support', 'body' => 'Bundles let you declare a named collection of registry dependencies with no source files.', 'changes' => 5],
        ['version' => 'v2.1.2', 'date' => '2026-03-22', 'dateLabel' => 'Mar 22, 2026', 'category' => 'Fixed', 'variant' => 'destructive', 'title' => 'JIT arbitrary-class splicing bug', 'body' => 'Tailwind JIT no longer purges animation utilities constructed by splicing a variable into an arbitrary class.', 'changes' => 2],
    ];
@endphp

<x-ui.section space="xl" {{ $attributes }}>
    <div class="mx-auto max-w-5xl px-4">
        <div class="mx-auto mb-12 max-w-2xl text-center sm:mb-16">
            <h2 class="text-3xl font-bold tracking-tight sm:text-4xl">{{ __($heading) }}</h2>
            <p class="mt-4 text-base text-muted-foreground sm:text-lg">{{ __($lead) }}</p>
            <a href="{{ $subscribeHref }}" class="mt-6 inline-flex items-center gap-2 rounded-md border border-border px-4 py-2 text-sm font-medium text-foreground transition-colors hover:bg-accent hover:text-accent-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">
                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="size-4" aria-hidden="true"><rect width="20" height="16" x="2" y="4" rx="2" /><path d="m22 7-8.97 5.7a1.94 1.94 0 0 1-2.06 0L2 7" /></svg>
                {{ __($subscribeLabel) }}
            </a>
        </div>

        <ol class="grid gap-6 sm:grid-cols-2 lg:grid-cols-3" aria-label="{{ __('Release history') }}">
            @foreach ($releases as $release)
                <li class="flex">
                    <x-ui.card class="flex w-full flex-col p-6">
                        <div class="mb-4 flex items-center justify-between gap-2">
                            <x-ui.badge variant="outline" size="sm">{{ $release['version'] }}</x-ui.badge>
                            <time datetime="{{ $release['date'] }}" class="text-sm text-muted-foreground">{{ __($release['dateLabel']) }}</time>
                        </div>
                        <div class="mb-4"><x-ui.badge :variant="$release['variant']" size="sm">{{ __($release['category']) }}</x-ui.badge></div>
                        <h3 class="mb-2 text-sm font-semibold leading-snug">{{ __($release['title']) }}</h3>
                        <p class="grow text-sm leading-relaxed text-muted-foreground">{{ __($release['body']) }}</p>
                        <div class="mt-4 flex items-center gap-2 border-t border-border pt-4 text-sm text-muted-foreground">
                            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="size-3" aria-hidden="true"><polyline points="16 18 22 12 16 6" /><polyline points="8 6 2 12 8 18" /></svg>
                            {{ trans_choice(':count change|:count changes', $release['changes'], ['count' => $release['changes']]) }}
                        </div>
                    </x-ui.card>
                </li>
            @endforeach
        </ol>
    </div>
</x-ui.section>

Installation

terminal

php artisan ui:add blocks/changelog-cards

Installs these dependencies automatically:

badge card section

Registry contract

Install confidence

php artisan ui:add blocks/changelog-cards writes only the generated targets below. The CLI validates each file hash before writing and prompts before replacing local changes unless --force is used.

Version: 1.0.4
License: open
Stability: stable
Contract: v1
Foundation: ≥ 1.0.0

Type	Generated target
blade	resources/views/blocks/changelog-cards.blade.php

Registry dependencies

badge card section

Package dependencies

composer: jml/brok:^0.2

Use with AI

A brief for your coding agent: what the block is, the install command, how to render it, its props and the rules. Copy it, or open a prompt about this block in an assistant.

changelog-cards.md

# Brok UI block: Changelog Cards (`changelog-cards`)

A changelog as a responsive grid of release cards, each with a version badge, category tag, summary and change count.

Brok UI is a Laravel Blade registry. `ui:add` copies this block into the app as plain Blade the app owns; it composes installed `<brok:*>` primitives and semantic design tokens.

## Install

```bash
php artisan ui:add blocks/changelog-cards
```

## Render it

```blade
<x-blocks.changelog-cards />
```

## Props

- `heading` (string, default `What\'s new`)
- `lead` (string, default `Every release, shipped to your inbox before it hits the docs.`)
- `subscribe-label` (string, default `Subscribe to updates`)
- `subscribe-href` (string, default `#`)
- `releases` (mixed|null, default `null`)

## Use when

- Publishing release notes as a responsive grid of cards, each with a version badge, category tag, summary and change count.
- Giving a changelog page a scannable, card-based layout rather than a single timeline.

## Avoid when

- Use changelog-version-rail for a timeline with a sticky rail, or changelog-date-rail for a date-marker timeline with images.

## Rules

- Render the installed block with `<x-blocks.changelog-cards />` and pass data through its props; edit the copied file only for structural changes.
- Keep the semantic design tokens (`bg-background`, `text-muted-foreground`); never swap in raw colour utilities.
- Keep the `data-slot` attributes and the logical (start/end) spacing so the markup still mirrors under `dir="rtl"`.

## Links

- Docs: https://brokui.dev/blocks/changelog-cards
- Registry JSON (files, props, contract): https://brokui.dev/r/open/blocks/changelog-cards.json

Ask about Changelog Cards in

Working in Claude Code, Cursor or Codex? Give the agent the whole registry through the MCP server or the Brok UI skill.

Guidance

Use when

Publishing release notes as a responsive grid of cards, each with a version badge, category tag, summary and change count.
Giving a changelog page a scannable, card-based layout rather than a single timeline.

Avoid when

Use changelog-version-rail for a timeline with a sticky rail, or changelog-date-rail for a date-marker timeline with images.

Anti-patterns

Do not replace semantic props with conflicting utility classes.
Do not remove labels, focus styles, or state attributes.

Usage

Render the block as a component, passing data where useful:

resources/views/welcome.blade.php Blade

<x-blocks.changelog-cards />

Built from primitives

Composes <brok:*> Semantic tokens Re-themeable RTL-ready

This block composes installed <brok:*> primitives and semantic design tokens only — it does not reimplement any primitive. Re-theme it (light, dark, admin, customer) by editing CSS variables; flip the preview to RTL to confirm it mirrors.

Source

The exact, editable file ui:add writes into your app. The preview above renders this same source — there are no preview-only blocks.