# Changelog 1 - Changelog with sticky version and date rail

> Stacked release entries pair a narrow sticky column of version badge and date with titles, descriptions, optional bullet lists, images, and external learn-more links.

A shadcn/ui block from the [@shadcnblocks](https://shadcnblocks.com) registry, listed on [shadcn.exchange](https://shadcn.exchange/r/shadcnblocks/changelog1).

- Page, with a live preview: https://shadcn.exchange/r/shadcnblocks/changelog1
- Screenshot: https://abzjhwgwpdpz7ua5.public.blob.vercel-storage.com/shots/shadcnblocks/changelog1-light-a23ba69678a0e6d2.png
- Registry item: https://shadcnblocks.com/r/changelog1.json
- Listed: 2026-10-13, source last changed 2026-10-13

## Install

```bash
npx shadcn@latest add https://shadcnblocks.com/r/changelog1.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: `cn`, `lucide-react`
- Registry items: `badge`, `button`

## Files

### `block/changelog1/changelog1.tsx`

```tsx
import { ArrowUpRight } from "lucide-react";
import { cn } from "cn";

import { Badge } from "@/components/ui/badge";
import { Button } from "@/components/ui/button";

interface ChangelogTag {
  label: string;
  dotClassName: string;
}
interface ChangelogEntry {
  date: string;
  title: string;
  version?: string;
  description?: string;
  items?: string[];
  image?: Image;
  imageClassName?: string;
  button?: Button;
  tags?: ChangelogTag[];
  body?: React.ReactNode;
  contributors?: Image[];
  category?: string;
  author?: string;
  role?: string;
  avatar?: Image;
}
interface Image {
  src: string;
  alt: string;
  srcDark?: string;
}
interface Button {
  text: string;
  url: string;
  icon?: React.ReactNode;
}

interface ChangelogProps {
  heading: string;
  description?: string;
  entries: ChangelogEntry[];
  className?: string;
}

interface Changelog1Props extends ChangelogProps {}
type Props = Partial<Changelog1Props>;

const person1 = {
  name: "Jack Walsh",
  firstName: "Jack",
  lastName: "Walsh",
  initials: "JW",
  email: "jack.walsh@example.com",
  username: "jackwalsh",
  role: "Product Designer",
  company: "Cartwright",
  location: "Brisbane, Australia",
  avatar: "https://cdn.shadcnblocks.com/shadcnblocks/image-set/modern/avatars/avatar1.webp",
};
const person2 = {
  name: "Ilze Pērkone",
  firstName: "Ilze",
  lastName: "Pērkone",
  initials: "MK",
  email: "iperkone@example.com",
  username: "iperkone",
  role: "Brand Director",
  company: "Kivit",
  location: "Rīga, Latvia",
  avatar: "https://cdn.shadcnblocks.com/shadcnblocks/image-set/modern/avatars/avatar2.webp",
};
const person3 = {
  name: "Vernon Desilets",
  firstName: "Vernon",
  lastName: "Desilets",
  initials: "VD",
  email: "vernod@example.com",
  username: "vernod",
  role: "Creative Director",
  company: "Soho Logix",
  location: "Paris, France",
  avatar: "https://cdn.shadcnblocks.com/shadcnblocks/image-set/modern/avatars/avatar3.webp",
};
const person4 = {
  name: "Lín Wàngshū",
  firstName: "Lín",
  lastName: "Wangshu",
  initials: "LW",
  email: "linwang4@example.com",
  username: "liwang",
  role: "Graphic Designer",
  company: "Tenxcloud",
  location: "Shanghai, China",
  avatar: "https://cdn.shadcnblocks.com/shadcnblocks/image-set/modern/avatars/avatar4.webp",
};
const person5 = {
  name: "Rajesh Bhatt",
  firstName: "Rajesh",
  lastName: "Bhatt",
  initials: "RB",
  email: "rajesh.bhatt@example.com",
  username: "rajeshbhatt",
  role: "UX Researcher",
  company: "Mindtree",
  location: "Mumbai, India",
  avatar: "https://cdn.shadcnblocks.com/shadcnblocks/image-set/modern/avatars/avatar5.webp",
};
const person6 = {
  name: "Jessica Cannon",
  firstName: "Jessica",
  lastName: "Cannon",
  initials: "JC",
  email: "jessica.cannon@example.com",
  username: "jessicacannon",
  role: "Data Analyst",
  company: "Fidelity Investments",
  location: "Boston, USA",
  avatar: "https://cdn.shadcnblocks.com/shadcnblocks/image-set/modern/avatars/avatar6.webp",
};
const defaultProps: Changelog1Props = {
  heading: "Changelog",
  description: "Get the latest updates and improvements to our platform.",
  entries: [
    {
      version: "Version 1.3.0",
      date: "15 November 2024",
      title: "Enhanced Analytics Dashboard",
      category: "New feature",
      author: person1.name,
      role: "Product Manager",
      avatar: {
        src: person1.avatar,
        alt: person1.name,
      },
      description:
        "We've completely redesigned our analytics dashboard to provide deeper insights and improved visualizations of your data.",
      tags: [
        { label: "Feature", dotClassName: "bg-blue-500" },
        { label: "Documentation", dotClassName: "bg-purple-500" },
      ],
      image: {
        src: "https://cdn.shadcnblocks.com/shadcnblocks/image-set/modern/changelog/analytics-16x9.png",
        alt: "Analytics dashboard",
      },
      imageClassName: "object-top-left",
      button: {
        url: "https://shadcnblocks.com",
        text: "Learn more",
      },
      contributors: [
        {
          src: person1.avatar,
          alt: person1.name,
        },
        {
          src: person2.avatar,
          alt: person2.name,
        },
        {
          src: person5.avatar,
          alt: person5.name,
        },
        {
          src: person6.avatar,
          alt: person6.name,
        },
      ],
      body: (
        <>
          <p>
            We&apos;ve completely redesigned the analytics dashboard so you can
            see what changed in a release without leaving the page. The new
            charts update as data arrives, and you can open the{" "}
            <a href="#">analytics guide</a> for the full walkthrough.
          </p>
          <p>
            Exports now cover the views people ask for most. Read the{" "}
            <a href="#">release notes</a> for the file formats and the filters
            that ship with this version.
          </p>
        </>
      ),
    },
    {
      version: "Version 1.2.1",
      date: "23 September 2024",
      title: "New features and improvements",
      category: "Improvement",
      author: person3.name,
      role: "Lead Product Designer",
      avatar: {
        src: person3.avatar,
        alt: person3.name,
      },
      description:
        "Here are the latest updates and improvements to our platform. We are always working to improve our platform and your experience.",
      items: [
        "Added new feature to export data",
        "Improved performance and speed",
        "Fixed minor bugs and issues",
        "Added new feature to import data",
      ],
      tags: [
        { label: "Maintenance", dotClassName: "bg-amber-400" },
        { label: "Security", dotClassName: "bg-red-500" },
      ],
      contributors: [
        {
          src: person3.avatar,
          alt: person3.name,
        },
        {
          src: person4.avatar,
          alt: person4.name,
        },
        {
          src: person5.avatar,
          alt: person5.name,
        },
      ],
      body: (
        <>
          <p>
            Here are the latest updates and improvements to our platform. We are
            always working to improve our platform and your experience.
          </p>
          <ul>
            <li>Added new feature to export data</li>
            <li>Improved performance and speed</li>
            <li>Fixed minor bugs and issues</li>
            <li>Added new feature to import data</li>
          </ul>
        </>
      ),
    },
    {
      version: "Version 1.2.5",
      date: "7 October 2024",
      title: "Mobile App Launch",
      category: "Update",
      author: person2.name,
      role: "AI Research Lead",
      avatar: {
        src: person2.avatar,
        alt: person2.name,
      },
      description:
        "We're excited to announce the launch of our mobile application, available now on iOS and Android platforms.",
      items: [
        "Native mobile experience for on-the-go productivity",
        "Offline mode support for working without internet connection",
        "Push notifications for important updates",
        "Biometric authentication for enhanced security",
      ],
      tags: [
        { label: "Feature", dotClassName: "bg-blue-500" },
        { label: "Maintenance", dotClassName: "bg-amber-400" },
      ],
      image: {
        src: "https://cdn.shadcnblocks.com/shadcnblocks/image-set/modern/changelog/phones-16x9.jpg",
        alt: "iPhone and Android phones",
      },
      button: {
        url: "https://shadcnblocks.com",
        text: "Learn more",
      },
      contributors: [
        {
          src: person2.avatar,
          alt: person2.name,
        },
        {
          src: person3.avatar,
          alt: person3.name,
        },
      ],
      body: (
        <>
          <p>
            We&apos;re excited to announce the launch of our mobile application,
            available now on iOS and Android platforms.
          </p>
          <ul>
            <li>Native mobile experience for on-the-go productivity</li>
            <li>
              Offline mode support for working without internet connection
            </li>
            <li>Push notifications for important updates</li>
            <li>Biometric authentication for enhanced security</li>
          </ul>
        </>
      ),
    },
    {
      version: "Version 1.0.0",
      date: "31 August 2024",
      title: "First version of our platform",
      category: "New feature",
      author: person1.name,
      role: "Product Manager",
      avatar: {
        src: person1.avatar,
        alt: person1.name,
      },
      description:
        "Introducing a new platform to help you manage your projects and tasks. We are excited to launch our platform and help you get started. We are always working to improve our platform and your experience.",
      tags: [{ label: "Feature", dotClassName: "bg-blue-500" }],
      button: {
        url: "https://shadcnblocks.com",
        text: "Learn more",
      },
      contributors: [
        {
          src: person1.avatar,
          alt: person1.name,
        },
        {
          src: person6.avatar,
          alt: person6.name,
        },
      ],
      body: (
        <>
          <p>
            Introducing a new platform to help you manage your projects and
            tasks. We are excited to launch our platform and help you get
            started.
          </p>
          <ul>
            <li>Project and task management in one place</li>
            <li>Shared workspaces for your team</li>
            <li>A first set of reports and exports</li>
          </ul>
          <p>
            Install the first release from the{" "}
            <a href="#">getting started guide</a>.
          </p>
          <pre>
            <code>npm install @shadcnblocks/platform</code>
          </pre>
        </>
      ),
    },
  ],
};

const Changelog1 = (props: Props) => {
  const { heading, description, entries, className } = {
    ...defaultProps,
    ...props,
  };
  return (
    <section className={cn("py-32", className)}>
      <div className="container">
        <div className="mx-auto max-w-4xl">
          <h1 className="mb-4 text-3xl font-bold tracking-tight md:text-5xl">
            {heading}
          </h1>
          <p className="mb-6 text-base text-muted-foreground md:text-lg">
            {description}
          </p>
        </div>
        <div className="mx-auto mt-16 max-w-4xl space-y-16 md:mt-24 md:space-y-24">
          {entries.map((entry, index) => (
            <div
              key={index}
              className="relative flex flex-col gap-4 md:flex-row md:gap-16"
            >
              <div className="top-8 flex h-min w-64 shrink-0 items-center gap-4 md:sticky">
                <Badge variant="secondary" className="text-xs">
                  {entry.version}
                </Badge>
                <span className="text-xs font-medium text-muted-foreground">
                  {entry.date}
                </span>
              </div>
              <div className="flex flex-col">
                <h2 className="mb-3 text-lg leading-tight font-bold text-foreground/90 md:text-2xl">
                  {entry.title}
                </h2>
                {entry.items && entry.items.length > 0 ? (
                  <>
                    <p className="text-sm text-muted-foreground md:text-base">
                      {entry.description}
                    </p>
                    <ul className="mt-4 ml-4 space-y-1.5 text-sm text-muted-foreground md:text-base">
                      {entry.items.map((item, itemIndex) => (
                        <li key={itemIndex} className="list-disc">
                          {item}
                        </li>
                      ))}
                    </ul>
                  </>
                ) : (
                  <div className="prose text-sm text-muted-foreground md:text-base dark:prose-invert">
                    {entry.body ?? <p>{entry.description}</p>}
                  </div>
                )}
                {entry.image && (
                  <img
                    src={entry.image.src}
                    alt={entry.image.alt}
                    className="mt-8 w-full rounded-lg border border-border object-cover"
                  />
                )}
                {entry.button && (
                  <Button variant="link" className="mt-4 self-end" asChild>
                    <a href={entry.button.url} target="_blank">
                      {entry.button.text} <ArrowUpRight className="h-4 w-4" />
                    </a>
                  </Button>
                )}
              </div>
            </div>
          ))}
        </div>
      </div>
    </section>
  );
};

export { Changelog1 };
```