# Grouped Changelog

> Updates clustered by month or release so related entries sit together. Good for products with frequent shipping where context across versions matters.

A shadcn/ui block from the [@shadcn-ui-blocks](https://www.shadcn-ui-blocks.com) registry, listed on [shadcn.exchange](https://shadcn.exchange/r/shadcn-ui-blocks/marketing-changelogs-grouped-changelog).

- Page, with a live preview: https://shadcn.exchange/r/shadcn-ui-blocks/marketing-changelogs-grouped-changelog
- Screenshot: https://abzjhwgwpdpz7ua5.public.blob.vercel-storage.com/shots/shadcn-ui-blocks/marketing-changelogs-grouped-changelog-light-45b2be3d8d31622e.png
- Registry item: https://www.shadcn-ui-blocks.com/r/marketing-changelogs-grouped-changelog.json
- Listed: 2026-10-13, source last changed 2026-10-13

## Install

```bash
npx shadcn@latest add https://www.shadcn-ui-blocks.com/r/marketing-changelogs-grouped-changelog.json
```

Run it in a project that has shadcn/ui set up. It adds the files below and installs what they depend on.

## Dependencies

- npm packages: `class-variance-authority`, `lucide-react`, `radix-ui`

## Files

### `components/blocks/marketing/changelogs/grouped-changelog.tsx`

```tsx
import * as React from 'react';
import { Badge } from '@/components/ui/badge';
import { Card, CardContent } from '@/components/ui/card';
import {
  Accordion,
  AccordionContent,
  AccordionItem,
  AccordionTrigger,
} from '@/components/ui/accordion';
import { cn } from '@/lib/utils';

interface ChangelogItem {
  version: string;
  date: string;
  isLatest: boolean;
  changes: {
    type: 'feature' | 'improvement' | 'bugfix' | 'breaking';
    description: string;
  }[];
}

interface TimeGroup {
  year: number;
  quarters: {
    quarter: number;
    releases: ChangelogItem[];
  }[];
}

export default function GroupedChangelog() {
  // Sample data
  const changelogData: ChangelogItem[] = [
    {
      version: '2.0.0',
      date: '2023-04-15',
      isLatest: true,
      changes: [
        {
          type: 'feature',
          description: 'Completely redesigned dashboard interface',
        },
        {
          type: 'feature',
          description: 'Added dark mode support across all pages',
        },
        { type: 'improvement', description: 'Improved performance by 40%' },
        { type: 'bugfix', description: 'Fixed multiple accessibility issues' },
        {
          type: 'breaking',
          description: 'API endpoints restructured for v2',
        },
      ],
    },
    {
      version: '1.9.0',
      date: '2023-02-10',
      isLatest: false,
      changes: [
        { type: 'feature', description: 'Added export to PDF functionality' },
        { type: 'improvement', description: 'Enhanced search performance' },
        { type: 'bugfix', description: 'Fixed login issues on Safari' },
      ],
    },
    {
      version: '1.8.5',
      date: '2022-12-07',
      isLatest: false,
      changes: [
        {
          type: 'improvement',
          description: 'Year-end performance optimizations',
        },
        { type: 'bugfix', description: 'Fixed data visualization issues' },
      ],
    },
    {
      version: '1.8.0',
      date: '2022-10-20',
      isLatest: false,
      changes: [
        { type: 'feature', description: 'New data visualization options' },
        { type: 'feature', description: 'Added team collaboration features' },
        { type: 'improvement', description: 'Updated documentation' },
      ],
    },
    {
      version: '1.7.0',
      date: '2022-08-05',
      isLatest: false,
      changes: [
        { type: 'feature', description: 'Added user roles and permissions' },
        { type: 'bugfix', description: 'Fixed several UI glitches' },
      ],
    },
    {
      version: '1.6.0',
      date: '2022-05-12',
      isLatest: false,
      changes: [
        { type: 'feature', description: 'Integrated third-party API services' },
        { type: 'improvement', description: 'Enhanced mobile experience' },
      ],
    },
    {
      version: '1.5.0',
      date: '2022-02-28',
      isLatest: false,
      changes: [
        { type: 'feature', description: 'Added custom report builder' },
        { type: 'improvement', description: 'Improved data loading times' },
      ],
    },
    {
      version: '1.4.0',
      date: '2021-11-18',
      isLatest: false,
      changes: [
        { type: 'feature', description: 'Added multi-language support' },
        { type: 'bugfix', description: 'Fixed account settings issues' },
      ],
    },
  ];

  // Group data by year and quarter
  const groupedData: TimeGroup[] = React.useMemo(() => {
    const groups: Record<number, TimeGroup> = {};

    changelogData.forEach((item) => {
      const date = new Date(item.date);
      const year = date.getFullYear();
      const quarter = Math.floor(date.getMonth() / 3) + 1;

      if (!groups[year]) {
        groups[year] = { year, quarters: [] };
      }

      let quarterGroup = groups[year].quarters.find(
        (q) => q.quarter === quarter
      );
      if (!quarterGroup) {
        quarterGroup = { quarter, releases: [] };
        groups[year].quarters.push(quarterGroup);
      }

      quarterGroup.releases.push(item);
    });

    // Sort quarters in descending order
    Object.values(groups).forEach((yearGroup) => {
      yearGroup.quarters.sort((a, b) => b.quarter - a.quarter);
      yearGroup.quarters.forEach((quarter) => {
        quarter.releases.sort(
          (a, b) => new Date(b.date).getTime() - new Date(a.date).getTime()
        );
      });
    });

    // Sort years in descending order
    return Object.values(groups).sort((a, b) => b.year - a.year);
  }, [changelogData]);

  // Get quarterly name
  const getQuarterName = (quarter: number) => {
    return `Q${quarter}`;
  };

  // Format date for display
  const formatDate = (dateString: string) => {
    const options: Intl.DateTimeFormatOptions = {
      year: 'numeric',
      month: 'long',
      day: 'numeric',
    };
    return new Date(dateString).toLocaleDateString('en-US', options);
  };

  // Change type styling
  const getChangeTypeStyles = (type: string) => {
    switch (type) {
      case 'feature':
        return 'bg-green-100 text-green-800 dark:bg-green-900/30 dark:text-green-400 border-transparent';
      case 'improvement':
        return 'bg-blue-100 text-blue-800 dark:bg-blue-900/30 dark:text-blue-400 border-transparent';
      case 'bugfix':
        return 'bg-red-100 text-red-800 dark:bg-red-900/30 dark:text-red-400 border-transparent';
      case 'breaking':
        return 'bg-amber-100 text-amber-800 dark:bg-amber-900/30 dark:text-amber-400 border-transparent';
      default:
        return 'bg-gray-100 text-gray-800 dark:bg-gray-800 dark:text-gray-200 border-transparent';
    }
  };

  // Get change type label
  const getChangeTypeLabel = (type: string) => {
    switch (type) {
      case 'feature':
        return 'New';
      case 'improvement':
        return 'Improved';
      case 'bugfix':
        return 'Fixed';
      case 'breaking':
        return 'Breaking';
      default:
        return type;
    }
  };

  return (
    <div className="container mx-auto max-w-4xl px-4 py-8">
      <div className="mb-8">
        <h2 className="text-3xl font-bold tracking-tight">Changelog</h2>
        <p className="text-muted-foreground mt-2">
          History of changes organized by year and quarter
        </p>
      </div>

      <div className="space-y-6">
        {groupedData.map((yearGroup) => (
          <Accordion
            type="single"
            collapsible
            className="w-full"
            defaultValue={yearGroup.year.toString()}
            key={yearGroup.year}
          >
            <AccordionItem
              value={yearGroup.year.toString()}
              className="border-b-0"
            >
              <AccordionTrigger className="bg-muted/50 hover:bg-muted rounded-lg px-4 py-3 hover:no-underline data-[state=open]:rounded-b-none">
                <span className="text-xl font-bold">{yearGroup.year}</span>
              </AccordionTrigger>
              <AccordionContent className="pt-0 pb-0">
                <div className="space-y-6 pb-6">
                  {yearGroup.quarters.map((quarter) => (
                    <div
                      key={`${yearGroup.year}-Q${quarter.quarter}`}
                      className="rounded-lg border border-dashed p-3 sm:p-4"
                    >
                      <h3 className="mb-4 flex flex-wrap items-center gap-2 text-lg font-semibold">
                        <span className="text-muted-foreground text-sm font-medium">
                          {yearGroup.year}
                        </span>
                        <Badge variant="outline" className="bg-muted/50">
                          {getQuarterName(quarter.quarter)}
                        </Badge>
                      </h3>
                      <div className="space-y-4">
                        {quarter.releases.map((release) => (
                          <Card
                            key={release.version}
                            className="overflow-hidden pt-0"
                          >
                            <CardContent className="p-0">
                              <div className="bg-muted/30 border-b p-3 sm:p-4">
                                <div className="flex flex-col gap-2 sm:flex-row sm:items-center">
                                  <div className="flex flex-wrap items-center gap-2">
                                    <h4 className="text-lg font-bold">
                                      v{release.version}
                                    </h4>
                                    {release.isLatest && (
                                      <Badge className="bg-primary text-primary-foreground">
                                        Latest
                                      </Badge>
                                    )}
                                  </div>
                                  <time className="text-muted-foreground text-sm sm:ml-auto">
                                    {formatDate(release.date)}
                                  </time>
                                </div>
                              </div>
                              <ul className="divide-y">
                                {release.changes.map((change, i) => (
                                  <li
                                    key={`${release.version}-${i}`}
                                    className="flex flex-col gap-2 p-3 sm:flex-row sm:items-start sm:p-4"
                                  >
                                    <Badge
                                      variant="outline"
                                      className={cn(
                                        'min-w-[60px] justify-center self-start rounded px-1.5 text-xs capitalize',
                                        getChangeTypeStyles(change.type)
                                      )}
                                    >
                                      {getChangeTypeLabel(change.type)}
                                    </Badge>
                                    <span className="break-words sm:ml-2">
                                      {change.description}
                                    </span>
                                  </li>
                                ))}
                              </ul>
                            </CardContent>
                          </Card>
                        ))}
                      </div>
                    </div>
                  ))}
                </div>
              </AccordionContent>
            </AccordionItem>
          </Accordion>
        ))}
      </div>
    </div>
  );
}
```

### `components/ui/badge.tsx`

```tsx
import * as React from "react"
import { cva, type VariantProps } from "class-variance-authority"
import { Slot } from "radix-ui"

import { cn } from "@/lib/utils"

const badgeVariants = cva(
  "group/badge inline-flex h-5 w-fit shrink-0 items-center justify-center gap-1 overflow-hidden rounded-4xl border border-transparent px-2 py-0.5 text-xs font-medium whitespace-nowrap transition-all focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 [&>svg]:pointer-events-none [&>svg]:size-3!",
  {
    variants: {
      variant: {
        default: "bg-primary text-primary-foreground [a]:hover:bg-primary/80",
        secondary:
          "bg-secondary text-secondary-foreground [a]:hover:bg-secondary/80",
        destructive:
          "bg-destructive/10 text-destructive focus-visible:ring-destructive/20 dark:bg-destructive/20 dark:focus-visible:ring-destructive/40 [a]:hover:bg-destructive/20",
        outline:
          "border-border text-foreground [a]:hover:bg-muted [a]:hover:text-muted-foreground",
        ghost:
          "hover:bg-muted hover:text-muted-foreground dark:hover:bg-muted/50",
        link: "text-primary underline-offset-4 hover:underline",
      },
    },
    defaultVariants: {
      variant: "default",
    },
  }
)

function Badge({
  className,
  variant = "default",
  asChild = false,
  ...props
}: React.ComponentProps<"span"> &
  VariantProps<typeof badgeVariants> & { asChild?: boolean }) {
  const Comp = asChild ? Slot.Root : "span"

  return (
    <Comp
      data-slot="badge"
      data-variant={variant}
      className={cn(badgeVariants({ variant }), className)}
      {...props}
    />
  )
}

export { Badge, badgeVariants }
```

### `components/ui/card.tsx`

```tsx
import * as React from "react"

import { cn } from "@/lib/utils"

function Card({
  className,
  size = "default",
  ...props
}: React.ComponentProps<"div"> & { size?: "default" | "sm" }) {
  return (
    <div
      data-slot="card"
      data-size={size}
      className={cn(
        "group/card flex flex-col gap-6 overflow-hidden rounded-xl bg-card py-6 text-sm text-card-foreground shadow-xs ring-1 ring-foreground/10 has-[>img:first-child]:pt-0 data-[size=sm]:gap-4 data-[size=sm]:py-4 *:[img:first-child]:rounded-t-xl *:[img:last-child]:rounded-b-xl",
        className
      )}
      {...props}
    />
  )
}

function CardHeader({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-header"
      className={cn(
        "group/card-header @container/card-header grid auto-rows-min items-start gap-1 rounded-t-xl px-6 group-data-[size=sm]/card:px-4 has-data-[slot=card-action]:grid-cols-[1fr_auto] has-data-[slot=card-description]:grid-rows-[auto_auto] [.border-b]:pb-6 group-data-[size=sm]/card:[.border-b]:pb-4",
        className
      )}
      {...props}
    />
  )
}

function CardTitle({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-title"
      className={cn(
        "font-heading text-base leading-normal font-medium group-data-[size=sm]/card:text-sm",
        className
      )}
      {...props}
    />
  )
}

function CardDescription({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-description"
      className={cn("text-sm text-muted-foreground", className)}
      {...props}
    />
  )
}

function CardAction({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-action"
      className={cn(
        "col-start-2 row-span-2 row-start-1 self-start justify-self-end",
        className
      )}
      {...props}
    />
  )
}

function CardContent({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-content"
      className={cn("px-6 group-data-[size=sm]/card:px-4", className)}
      {...props}
    />
  )
}

function CardFooter({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-footer"
      className={cn(
        "flex items-center rounded-b-xl px-6 group-data-[size=sm]/card:px-4 [.border-t]:pt-6 group-data-[size=sm]/card:[.border-t]:pt-4",
        className
      )}
      {...props}
    />
  )
}

export {
  Card,
  CardHeader,
  CardFooter,
  CardTitle,
  CardAction,
  CardDescription,
  CardContent,
}
```

### `components/ui/accordion.tsx`

```tsx
"use client"

import * as React from "react"
import { Accordion as AccordionPrimitive } from "radix-ui"

import { cn } from "@/lib/utils"
import { ChevronDownIcon, ChevronUpIcon } from "lucide-react"

function Accordion({
  className,
  ...props
}: React.ComponentProps<typeof AccordionPrimitive.Root>) {
  return (
    <AccordionPrimitive.Root
      data-slot="accordion"
      className={cn("flex w-full flex-col", className)}
      {...props}
    />
  )
}

function AccordionItem({
  className,
  ...props
}: React.ComponentProps<typeof AccordionPrimitive.Item>) {
  return (
    <AccordionPrimitive.Item
      data-slot="accordion-item"
      className={cn("not-last:border-b", className)}
      {...props}
    />
  )
}

function AccordionTrigger({
  className,
  children,
  ...props
}: React.ComponentProps<typeof AccordionPrimitive.Trigger>) {
  return (
    <AccordionPrimitive.Header className="flex">
      <AccordionPrimitive.Trigger
        data-slot="accordion-trigger"
        className={cn(
          "group/accordion-trigger relative flex flex-1 items-start justify-between rounded-md border border-transparent py-4 text-left text-sm font-medium transition-all outline-none hover:underline focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 focus-visible:after:border-ring disabled:pointer-events-none disabled:opacity-50 **:data-[slot=accordion-trigger-icon]:ml-auto **:data-[slot=accordion-trigger-icon]:size-4 **:data-[slot=accordion-trigger-icon]:text-muted-foreground",
          className
        )}
        {...props}
      >
        {children}
        <ChevronDownIcon data-slot="accordion-trigger-icon" className="pointer-events-none shrink-0 group-aria-expanded/accordion-trigger:hidden" />
        <ChevronUpIcon data-slot="accordion-trigger-icon" className="pointer-events-none hidden shrink-0 group-aria-expanded/accordion-trigger:inline" />
      </AccordionPrimitive.Trigger>
    </AccordionPrimitive.Header>
  )
}

function AccordionContent({
  className,
  children,
  ...props
}: React.ComponentProps<typeof AccordionPrimitive.Content>) {
  return (
    <AccordionPrimitive.Content
      data-slot="accordion-content"
      className="overflow-hidden text-sm data-open:animate-accordion-down data-closed:animate-accordion-up"
      {...props}
    >
      <div
        className={cn(
          "pt-0 pb-4 [&_a]:underline [&_a]:underline-offset-3 [&_a]:hover:text-foreground [&_p:not(:last-child)]:mb-4",
          className
        )}
      >
        {children}
      </div>
    </AccordionPrimitive.Content>
  )
}

export { Accordion, AccordionItem, AccordionTrigger, AccordionContent }
```