Blocks · Marketing
Changelog list
Releases newest first: the date and version beside the title, black and white tags and a line; a link to the full changelog and page links.
34% of 139 news overviews and 16% of 671 home pages we studied have a posts or changelog section.
Changelog
What changed lately
Rollbacks keep their environment variables
- New
- Improved
Rolling back now restores the variables a deploy went live with, not the ones you have today. The deploy page shows which set is live.
Version 2.8.0
Faster previews for large repositories
- Improved
Preview builds reuse the dependency cache of main, so a first preview of a big repository starts in seconds instead of minutes.
Version 2.7.0
Log search across regions
- Fixed
A search now finds requests served from every region, not only the one closest to you.
Version 2.6.1
The old deploy hook URL stops in January
- New
- Deprecated
Signed deploy hooks replace the plain URL. The old one keeps working until 31 January 2027.
Version 2.6.0
Changelog
What changed lately
Rollbacks keep their environment variables
- New
- Improved
Rolling back now restores the variables a deploy went live with, not the ones you have today. The deploy page shows which set is live.
Version 2.8.0
Faster previews for large repositories
- Improved
Preview builds reuse the dependency cache of main, so a first preview of a big repository starts in seconds instead of minutes.
Version 2.7.0
Log search across regions
- Fixed
A search now finds requests served from every region, not only the one closest to you.
Version 2.6.1
The old deploy hook URL stops in January
- New
- Deprecated
Signed deploy hooks replace the plain URL. The old one keeps working until 31 January 2027.
Version 2.6.0
Both previews render the same markup; the HTML tab below is that markup without a framework.
Install
- React
- npx shadcn@
latest add https:// www.themes.dev/ ui/ r/ changelog-list.json - Astro
- npx shadcn@
latest add https:// www.themes.dev/ ui/ r/ astro/ changelog-list.json
Or copy the files below into your project. They need clsx, tailwind-merge and the components they import, and the themes.dev UI theme. The HTML needs only the compiled CSS.
/** Changelog list: a section header (with an optional link to the full changelog), then releases newest first. Each
* release is one row: the date and version on the start side, the title (the release's one link, stretched over the
* row), its tags and a line or two. Releases separate by space; the date column carries the order. Tags are words in
* black and white badges: a status, not an action, so no colour (Deprecated reads as a word, not as red). */
export const changelogList = {
root: '@container bg-background px-6 py-16 text-foreground @3xl:py-24',
inner: 'mx-auto flex max-w-6xl flex-col gap-12',
list: 'm-0 flex list-none flex-col gap-12 p-0 @3xl:gap-14',
// The article positions the title link's ::after, which covers the whole release.
entry: 'group relative isolate grid gap-3 @3xl:grid-cols-4 @3xl:items-start @3xl:gap-x-10',
// Read after the title (DOM order), shown before it. Top-aligned with a nudge, not baseline: the title link is
// inline-block (24px target), so a two-line title would pull a baseline-aligned date down.
meta: 'order-first flex flex-wrap items-baseline gap-x-3 gap-y-1 text-sm text-muted-foreground tabular-nums @3xl:flex-col @3xl:gap-y-1 @3xl:pt-1',
version: 'font-medium text-foreground',
body: 'flex min-w-0 flex-col gap-3 @3xl:col-span-3',
title: 'text-xl leading-snug font-semibold tracking-[-0.02em] text-balance',
link: 'inline-block min-h-6 rounded-sm underline decoration-transparent underline-offset-4 transition-[text-decoration-color] after:absolute after:inset-0 after:z-10 group-hover:decoration-foreground/40 hover:decoration-foreground active:decoration-2',
tags: 'm-0 flex list-none flex-wrap gap-2 p-0',
summary: 'max-w-prose text-base text-pretty text-muted-foreground',
pagination: '-ms-2.5 self-start',
};
export const RELEASE_TAGS = ['new', 'improved', 'fixed', 'deprecated'] as const;
export type ReleaseTag = (typeof RELEASE_TAGS)[number];
export const TAG_LABEL: Record<ReleaseTag, string> = { new: 'New', improved: 'Improved', fixed: 'Fixed', deprecated: 'Deprecated' };
/** New stands out (filled); the others stay quiet. */
export const TAG_BADGE: Record<ReleaseTag, 'default' | 'secondary' | 'outline'> = { new: 'default', improved: 'secondary', fixed: 'outline', deprecated: 'outline' };
const MONTHS = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'];
/** 2026-10-28 → 28 October 2026. By hand rather than Intl, so the server and the browser write the same text. */
export const formatDate = (iso: string) => {
const [y, m, d] = iso.split('-').map(Number);
return `${d} ${MONTHS[m - 1]} ${y}`;
};
export type Release = {
title: string;
href: string;
/** Released, YYYY-MM-DD. */
date: string;
/** 2.8.0, or leave it out for a product without versions. */
version?: string;
/** Up to three of new, improved, fixed, deprecated. */
tags?: ReleaseTag[];
/** One or two sentences. */
summary?: string;
};
export type ChangelogListContent = {
kicker?: string;
title: string;
description?: string;
/** Beside the heading: the full changelog. */
link?: { href: string; label: string };
/** Newest first. */
releases: Release[];
pagination?: { page: number; pages: number; href: (page: number) => string };
/** Unique on the page; ids the heading. */
id: string;
};import { Badge } from '@/components/ui/badge';
import { Link } from '@/components/ui/link';
import { Pagination } from '@/components/ui/pagination';
import { SectionHeader } from '@/components/ui/section-header';
import { cn } from '@/lib/utils';
import { changelogList as c, formatDate, TAG_BADGE, TAG_LABEL, type ChangelogListContent } from './changelog-list.classes';
export type ChangelogListProps = ChangelogListContent & { className?: string };
/** Releases newest first: the date and version beside the title, its tags and a line; optional page links. */
export function ChangelogList({ kicker, title, description, link, releases, pagination, id, className }: ChangelogListProps) {
return (
<section aria-labelledby={`${id}-title`} className={cn(c.root, className)}>
<div className={c.inner}>
<SectionHeader id={`${id}-title`} kicker={kicker} title={title} description={description}>
{link && <Link href={link.href} variant="standalone">{link.label}</Link>}
</SectionHeader>
<ol role="list" className={c.list}>
{releases.map((r) => (
<li key={r.href}>
<article className={c.entry}>
<div className={c.body}>
<h3 className={c.title}><a href={r.href} className={c.link}>{r.title}</a></h3>
{r.tags?.length ? (
<ul role="list" aria-label="Changes" className={c.tags}>
{r.tags.map((t) => (
<li key={t}><Badge variant={TAG_BADGE[t]}>{TAG_LABEL[t]}</Badge></li>
))}
</ul>
) : null}
{r.summary && <p className={c.summary}>{r.summary}</p>}
</div>
<p className={c.meta}>
<time dateTime={r.date}>{formatDate(r.date)}</time>
{r.version && <span className={c.version}><span className="sr-only">Version </span>{r.version}</span>}
</p>
</article>
</li>
))}
</ol>
{pagination && <Pagination current={pagination.page} total={pagination.pages} href={pagination.href} label="Changelog pages" className={c.pagination} />}
</div>
</section>
);
}---
import Badge from '@/components/ui/badge.astro';
import Link from '@/components/ui/link.astro';
import Pagination from '@/components/ui/pagination.astro';
import SectionHeader from '@/components/ui/section-header.astro';
import { cn } from '@/lib/utils';
import { changelogList as c, formatDate, TAG_BADGE, TAG_LABEL, type ChangelogListContent } from './changelog-list.classes';
type Props = ChangelogListContent & { class?: string };
const { kicker, title, description, link, releases, pagination, id, class: className } = Astro.props;
---
<section aria-labelledby={`${id}-title`} class={cn(c.root, className)}>
<div class={c.inner}>
<SectionHeader id={`${id}-title`} kicker={kicker} title={title} description={description}>
{link && <Link href={link.href} variant="standalone">{link.label}</Link>}
</SectionHeader>
<ol role="list" class={c.list}>
{
releases.map((r) => (
<li>
<article class={c.entry}>
<div class={c.body}>
<h3 class={c.title}><a href={r.href} class={c.link}>{r.title}</a></h3>
{r.tags?.length ? (
<ul role="list" aria-label="Changes" class={c.tags}>
{r.tags.map((t) => (
<li><Badge variant={TAG_BADGE[t]}>{TAG_LABEL[t]}</Badge></li>
))}
</ul>
) : null}
{r.summary && <p class={c.summary}>{r.summary}</p>}
</div>
<p class={c.meta}>
<time datetime={r.date}>{formatDate(r.date)}</time>
{r.version && <span class={c.version}><span class="sr-only">Version </span>{r.version}</span>}
</p>
</article>
</li>
))
}
</ol>
{pagination && <Pagination current={pagination.page} total={pagination.pages} href={pagination.href} label="Changelog pages" class={c.pagination} />}
</div>
</section>/** Changelog list: a section header (with an optional link to the full changelog), then releases newest first. Each
* release is one row: the date and version on the start side, the title (the release's one link, stretched over the
* row), its tags and a line or two. Releases separate by space; the date column carries the order. Tags are words in
* black and white badges: a status, not an action, so no colour (Deprecated reads as a word, not as red). */
export const changelogList = {
root: '@container bg-background px-6 py-16 text-foreground @3xl:py-24',
inner: 'mx-auto flex max-w-6xl flex-col gap-12',
list: 'm-0 flex list-none flex-col gap-12 p-0 @3xl:gap-14',
// The article positions the title link's ::after, which covers the whole release.
entry: 'group relative isolate grid gap-3 @3xl:grid-cols-4 @3xl:items-start @3xl:gap-x-10',
// Read after the title (DOM order), shown before it. Top-aligned with a nudge, not baseline: the title link is
// inline-block (24px target), so a two-line title would pull a baseline-aligned date down.
meta: 'order-first flex flex-wrap items-baseline gap-x-3 gap-y-1 text-sm text-muted-foreground tabular-nums @3xl:flex-col @3xl:gap-y-1 @3xl:pt-1',
version: 'font-medium text-foreground',
body: 'flex min-w-0 flex-col gap-3 @3xl:col-span-3',
title: 'text-xl leading-snug font-semibold tracking-[-0.02em] text-balance',
link: 'inline-block min-h-6 rounded-sm underline decoration-transparent underline-offset-4 transition-[text-decoration-color] after:absolute after:inset-0 after:z-10 group-hover:decoration-foreground/40 hover:decoration-foreground active:decoration-2',
tags: 'm-0 flex list-none flex-wrap gap-2 p-0',
summary: 'max-w-prose text-base text-pretty text-muted-foreground',
pagination: '-ms-2.5 self-start',
};
export const RELEASE_TAGS = ['new', 'improved', 'fixed', 'deprecated'] as const;
export type ReleaseTag = (typeof RELEASE_TAGS)[number];
export const TAG_LABEL: Record<ReleaseTag, string> = { new: 'New', improved: 'Improved', fixed: 'Fixed', deprecated: 'Deprecated' };
/** New stands out (filled); the others stay quiet. */
export const TAG_BADGE: Record<ReleaseTag, 'default' | 'secondary' | 'outline'> = { new: 'default', improved: 'secondary', fixed: 'outline', deprecated: 'outline' };
const MONTHS = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'];
/** 2026-10-28 → 28 October 2026. By hand rather than Intl, so the server and the browser write the same text. */
export const formatDate = (iso: string) => {
const [y, m, d] = iso.split('-').map(Number);
return `${d} ${MONTHS[m - 1]} ${y}`;
};
export type Release = {
title: string;
href: string;
/** Released, YYYY-MM-DD. */
date: string;
/** 2.8.0, or leave it out for a product without versions. */
version?: string;
/** Up to three of new, improved, fixed, deprecated. */
tags?: ReleaseTag[];
/** One or two sentences. */
summary?: string;
};
export type ChangelogListContent = {
kicker?: string;
title: string;
description?: string;
/** Beside the heading: the full changelog. */
link?: { href: string; label: string };
/** Newest first. */
releases: Release[];
pagination?: { page: number; pages: number; href: (page: number) => string };
/** Unique on the page; ids the heading. */
id: string;
};<section aria-labelledby="ex-changelog-title" class="@container bg-background px-6 py-16 text-foreground @3xl:py-24">
<div class="mx-auto flex max-w-6xl flex-col gap-12">
<header class="@container w-full">
<div class="flex flex-wrap items-end justify-between gap-x-8 gap-y-4">
<div class="min-w-0 grow basis-[24rem]">
<p class="text-sm font-medium text-muted-foreground">Changelog</p>
<h2 id="ex-changelog-title" class="mt-2 text-3xl font-semibold tracking-[-0.03em] text-balance @xl:text-4xl">What changed lately</h2>
</div>
<div class="shrink-0">
<a href="#changelog" class="rounded-sm font-medium text-foreground underline-offset-4 transition-[color,text-decoration-color,background-color] active:bg-accent [&_svg]:size-3.5 [&_svg]:shrink-0 [&_svg]:transition-transform group inline-flex min-h-6 items-center gap-1.5 hover:underline active:decoration-2 hover:[&_svg]:translate-x-0.5">
Full changelog
<svg viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M3 8h10M9 4l4 4-4 4"></path></svg>
</a>
</div>
</div>
</header>
<ol role="list" class="m-0 flex list-none flex-col gap-12 p-0 @3xl:gap-14">
<li>
<article class="group relative isolate grid gap-3 @3xl:grid-cols-4 @3xl:items-start @3xl:gap-x-10">
<div class="flex min-w-0 flex-col gap-3 @3xl:col-span-3">
<h3 class="text-xl leading-snug font-semibold tracking-[-0.02em] text-balance">
<a href="#release-2-8" class="inline-block min-h-6 rounded-sm underline decoration-transparent underline-offset-4 transition-[text-decoration-color] after:absolute after:inset-0 after:z-10 group-hover:decoration-foreground/40 hover:decoration-foreground active:decoration-2">
Rollbacks keep their environment variables
</a>
</h3>
<ul role="list" aria-label="Changes" class="m-0 flex list-none flex-wrap gap-2 p-0">
<li>
<span class="inline-flex w-fit shrink-0 items-center gap-1 rounded-sm border px-1.5 py-0.5 text-xs font-medium whitespace-nowrap [&_svg]:size-3 border-transparent bg-foreground text-background">
New
</span>
</li>
<li>
<span class="inline-flex w-fit shrink-0 items-center gap-1 rounded-sm border px-1.5 py-0.5 text-xs font-medium whitespace-nowrap [&_svg]:size-3 border-transparent bg-secondary text-secondary-foreground">
Improved
</span>
</li>
</ul>
<p class="max-w-prose text-base text-pretty text-muted-foreground">
Rolling back now restores the variables a deploy went live with, not the ones you have today. The deploy page shows which set is live.
</p>
</div>
<p class="order-first flex flex-wrap items-baseline gap-x-3 gap-y-1 text-sm text-muted-foreground tabular-nums @3xl:flex-col @3xl:gap-y-1 @3xl:pt-1">
<time datetime="2026-11-04">4 November 2026</time>
<span class="font-medium text-foreground"><span class="sr-only">Version </span>2.8.0</span>
</p>
</article>
</li>
<li>
<article class="group relative isolate grid gap-3 @3xl:grid-cols-4 @3xl:items-start @3xl:gap-x-10">
<div class="flex min-w-0 flex-col gap-3 @3xl:col-span-3">
<h3 class="text-xl leading-snug font-semibold tracking-[-0.02em] text-balance">
<a href="#release-2-7" class="inline-block min-h-6 rounded-sm underline decoration-transparent underline-offset-4 transition-[text-decoration-color] after:absolute after:inset-0 after:z-10 group-hover:decoration-foreground/40 hover:decoration-foreground active:decoration-2">
Faster previews for large repositories
</a>
</h3>
<ul role="list" aria-label="Changes" class="m-0 flex list-none flex-wrap gap-2 p-0">
<li>
<span class="inline-flex w-fit shrink-0 items-center gap-1 rounded-sm border px-1.5 py-0.5 text-xs font-medium whitespace-nowrap [&_svg]:size-3 border-transparent bg-secondary text-secondary-foreground">
Improved
</span>
</li>
</ul>
<p class="max-w-prose text-base text-pretty text-muted-foreground">
Preview builds reuse the dependency cache of main, so a first preview of a big repository starts in seconds instead of minutes.
</p>
</div>
<p class="order-first flex flex-wrap items-baseline gap-x-3 gap-y-1 text-sm text-muted-foreground tabular-nums @3xl:flex-col @3xl:gap-y-1 @3xl:pt-1">
<time datetime="2026-10-21">21 October 2026</time>
<span class="font-medium text-foreground"><span class="sr-only">Version </span>2.7.0</span>
</p>
</article>
</li>
<li>
<article class="group relative isolate grid gap-3 @3xl:grid-cols-4 @3xl:items-start @3xl:gap-x-10">
<div class="flex min-w-0 flex-col gap-3 @3xl:col-span-3">
<h3 class="text-xl leading-snug font-semibold tracking-[-0.02em] text-balance">
<a href="#release-2-6-1" class="inline-block min-h-6 rounded-sm underline decoration-transparent underline-offset-4 transition-[text-decoration-color] after:absolute after:inset-0 after:z-10 group-hover:decoration-foreground/40 hover:decoration-foreground active:decoration-2">
Log search across regions
</a>
</h3>
<ul role="list" aria-label="Changes" class="m-0 flex list-none flex-wrap gap-2 p-0">
<li>
<span class="inline-flex w-fit shrink-0 items-center gap-1 rounded-sm border px-1.5 py-0.5 text-xs font-medium whitespace-nowrap [&_svg]:size-3 border-border text-foreground">
Fixed
</span>
</li>
</ul>
<p class="max-w-prose text-base text-pretty text-muted-foreground">A search now finds requests served from every region, not only the one closest to you.</p>
</div>
<p class="order-first flex flex-wrap items-baseline gap-x-3 gap-y-1 text-sm text-muted-foreground tabular-nums @3xl:flex-col @3xl:gap-y-1 @3xl:pt-1">
<time datetime="2026-10-09">9 October 2026</time>
<span class="font-medium text-foreground"><span class="sr-only">Version </span>2.6.1</span>
</p>
</article>
</li>
<li>
<article class="group relative isolate grid gap-3 @3xl:grid-cols-4 @3xl:items-start @3xl:gap-x-10">
<div class="flex min-w-0 flex-col gap-3 @3xl:col-span-3">
<h3 class="text-xl leading-snug font-semibold tracking-[-0.02em] text-balance">
<a href="#release-2-6" class="inline-block min-h-6 rounded-sm underline decoration-transparent underline-offset-4 transition-[text-decoration-color] after:absolute after:inset-0 after:z-10 group-hover:decoration-foreground/40 hover:decoration-foreground active:decoration-2">
The old deploy hook URL stops in January
</a>
</h3>
<ul role="list" aria-label="Changes" class="m-0 flex list-none flex-wrap gap-2 p-0">
<li>
<span class="inline-flex w-fit shrink-0 items-center gap-1 rounded-sm border px-1.5 py-0.5 text-xs font-medium whitespace-nowrap [&_svg]:size-3 border-transparent bg-foreground text-background">
New
</span>
</li>
<li>
<span class="inline-flex w-fit shrink-0 items-center gap-1 rounded-sm border px-1.5 py-0.5 text-xs font-medium whitespace-nowrap [&_svg]:size-3 border-border text-foreground">
Deprecated
</span>
</li>
</ul>
<p class="max-w-prose text-base text-pretty text-muted-foreground">
Signed deploy hooks replace the plain URL. The old one keeps working until 31 January 2027.
</p>
</div>
<p class="order-first flex flex-wrap items-baseline gap-x-3 gap-y-1 text-sm text-muted-foreground tabular-nums @3xl:flex-col @3xl:gap-y-1 @3xl:pt-1">
<time datetime="2026-09-30">30 September 2026</time>
<span class="font-medium text-foreground"><span class="sr-only">Version </span>2.6.0</span>
</p>
</article>
</li>
</ol>
<nav aria-label="Changelog pages" class="w-full @container -ms-2.5 self-start">
<ul class="m-0 flex list-none flex-wrap items-center gap-1 p-0">
<li>
<a aria-disabled="true" role="link" rel="prev" class="inline-flex h-9 min-w-9 cursor-pointer items-center justify-center gap-1 rounded-md border border-transparent px-2.5 text-sm font-medium tabular-nums transition-[color,background-color,transform] select-none hover:bg-accent active:scale-[0.97] active:bg-pressed aria-[current=page]:border aria-[current=page]:border-input aria-[current=page]:bg-background aria-[current=page]:shadow-[0_1px_2px_rgb(0_0_0/0.06)] aria-disabled:pointer-events-none aria-disabled:opacity-50 [&_svg]:size-4">
<svg viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M10 3.5L5.5 8l4.5 4.5"></path></svg>
<span class="@max-md:sr-only">Previous</span>
</a>
</li>
<li class="@max-lg:hidden">
<a href="#changelog-page-1" aria-current="page" aria-label="Page 1" class="inline-flex h-9 min-w-9 cursor-pointer items-center justify-center gap-1 rounded-md border border-transparent px-2.5 text-sm font-medium tabular-nums transition-[color,background-color,transform] select-none hover:bg-accent active:scale-[0.97] active:bg-pressed aria-[current=page]:border aria-[current=page]:border-input aria-[current=page]:bg-background aria-[current=page]:shadow-[0_1px_2px_rgb(0_0_0/0.06)] aria-disabled:pointer-events-none aria-disabled:opacity-50 [&_svg]:size-4">
1
</a>
</li>
<li class="@max-lg:hidden">
<a href="#changelog-page-2" aria-label="Page 2" class="inline-flex h-9 min-w-9 cursor-pointer items-center justify-center gap-1 rounded-md border border-transparent px-2.5 text-sm font-medium tabular-nums transition-[color,background-color,transform] select-none hover:bg-accent active:scale-[0.97] active:bg-pressed aria-[current=page]:border aria-[current=page]:border-input aria-[current=page]:bg-background aria-[current=page]:shadow-[0_1px_2px_rgb(0_0_0/0.06)] aria-disabled:pointer-events-none aria-disabled:opacity-50 [&_svg]:size-4">
2
</a>
</li>
<li class="@max-lg:hidden"><span aria-hidden="true" class="inline-flex h-9 min-w-6 items-center justify-center text-sm text-muted-foreground">…</span></li>
<li class="@max-lg:hidden">
<a href="#changelog-page-6" aria-label="Page 6" class="inline-flex h-9 min-w-9 cursor-pointer items-center justify-center gap-1 rounded-md border border-transparent px-2.5 text-sm font-medium tabular-nums transition-[color,background-color,transform] select-none hover:bg-accent active:scale-[0.97] active:bg-pressed aria-[current=page]:border aria-[current=page]:border-input aria-[current=page]:bg-background aria-[current=page]:shadow-[0_1px_2px_rgb(0_0_0/0.06)] aria-disabled:pointer-events-none aria-disabled:opacity-50 [&_svg]:size-4">
6
</a>
</li>
<li class="inline-flex h-9 items-center px-2 text-sm text-muted-foreground tabular-nums @lg:hidden">Page 1 of 6</li>
<li>
<a href="#changelog-page-2" rel="next" class="inline-flex h-9 min-w-9 cursor-pointer items-center justify-center gap-1 rounded-md border border-transparent px-2.5 text-sm font-medium tabular-nums transition-[color,background-color,transform] select-none hover:bg-accent active:scale-[0.97] active:bg-pressed aria-[current=page]:border aria-[current=page]:border-input aria-[current=page]:bg-background aria-[current=page]:shadow-[0_1px_2px_rgb(0_0_0/0.06)] aria-disabled:pointer-events-none aria-disabled:opacity-50 [&_svg]:size-4">
<span class="@max-md:sr-only">Next</span>
<svg viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M6 3.5l4.5 4.5L6 12.5"></path></svg>
</a>
</li>
</ul>
</nav>
</div>
</section>