# Timeline Changelog

> A vertical timeline that plots releases in order with dates and notes. Use it to tell the story of a product as it grows version over version.

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-timeline-changelog).

- Page, with a live preview: https://shadcn.exchange/r/shadcn-ui-blocks/marketing-changelogs-timeline-changelog
- Screenshot: https://abzjhwgwpdpz7ua5.public.blob.vercel-storage.com/shots/shadcn-ui-blocks/marketing-changelogs-timeline-changelog-light-df46d1acba3fd806.png
- Registry item: https://www.shadcn-ui-blocks.com/r/marketing-changelogs-timeline-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-timeline-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`, `radix-ui`

## Files

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

```tsx
import { Badge } from "@/components/ui/badge";

export default function TimelineChangelog() {
  return (
    <div className="container mx-auto max-w-3xl 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">
          All notable changes to our product will be documented here.
        </p>
      </div>

      <div className="lg:before:bg-border relative space-y-8 lg:ml-5 lg:before:absolute lg:before:inset-0 lg:before:left-[57.5px] lg:before:ml-0 lg:before:h-full lg:before:w-0.5">
        {/* Version 2.0.0 */}
        <div className="relative flex flex-col gap-4 lg:flex-row">
          <div className="hidden items-center justify-center lg:flex lg:w-1/6">
            <div className="bg-primary text-primary-foreground z-10 flex h-10 w-10 items-center justify-center rounded-full shadow">
              <svg
                xmlns="http://www.w3.org/2000/svg"
                width="20"
                height="20"
                viewBox="0 0 24 24"
                fill="none"
                stroke="currentColor"
                strokeWidth="2"
                strokeLinecap="round"
                strokeLinejoin="round"
                className="lucide lucide-rocket"
              >
                <path d="M4.5 16.5c-1.5 1.26-2 5-2 5s3.74-.5 5-2c.71-.84.7-2.13-.09-2.91a2.18 2.18 0 0 0-2.91-.09z"></path>
                <path d="m12 15-3-3a22 22 0 0 1 2-3.95A12.88 12.88 0 0 1 22 2c0 2.72-.78 7.5-6 11a22.35 22.35 0 0 1-4 2z"></path>
                <path d="M9 12H4s.55-3.03 2-4c1.62-1.08 5 0 5 0"></path>
                <path d="M12 15v5s3.03-.55 4-2c1.08-1.62 0-5 0-5"></path>
              </svg>
            </div>
          </div>
          <div className="bg-card w-full rounded-lg border p-6 shadow-sm lg:w-5/6">
            <div className="mb-2 flex items-center gap-2">
              <h3 className="text-xl font-bold">Version 2.0.0</h3>
              <Badge className="px-2">Latest</Badge>
            </div>
            <time className="text-muted-foreground text-sm">
              April 15, 2023
            </time>
            <ul className="mt-4 list-disc space-y-1.5 pl-5">
              <li>Completely redesigned dashboard interface</li>
              <li>Added dark mode support across all pages</li>
              <li>Improved performance by 40%</li>
              <li>Fixed multiple accessibility issues</li>
            </ul>
          </div>
        </div>

        {/* Version 1.2.0 */}
        <div className="relative flex flex-col gap-4 lg:flex-row">
          <div className="hidden items-center justify-center lg:flex lg:w-1/6">
            <div className="bg-secondary text-secondary-foreground z-10 flex h-10 w-10 items-center justify-center rounded-full shadow">
              <svg
                xmlns="http://www.w3.org/2000/svg"
                width="20"
                height="20"
                viewBox="0 0 24 24"
                fill="none"
                stroke="currentColor"
                strokeWidth="2"
                strokeLinecap="round"
                strokeLinejoin="round"
                className="lucide lucide-zap"
              >
                <polygon points="13 2 3 14 12 14 11 22 21 10 12 10 13 2"></polygon>
              </svg>
            </div>
          </div>
          <div className="bg-card w-full rounded-lg border p-6 shadow-sm lg:w-5/6">
            <h3 className="mb-2 text-xl font-bold">Version 1.2.0</h3>
            <time className="text-muted-foreground text-sm">March 2, 2023</time>
            <ul className="mt-4 list-disc space-y-1.5 pl-5">
              <li>Added new analytics dashboard</li>
              <li>Improved mobile responsiveness</li>
              <li>Fixed bug with user authentication</li>
            </ul>
          </div>
        </div>

        {/* Version 1.1.0 */}
        <div className="relative flex flex-col gap-4 lg:flex-row">
          <div className="hidden items-center justify-center lg:flex lg:w-1/6">
            <div className="bg-muted text-muted-foreground z-10 flex h-10 w-10 items-center justify-center rounded-full shadow">
              <svg
                xmlns="http://www.w3.org/2000/svg"
                width="20"
                height="20"
                viewBox="0 0 24 24"
                fill="none"
                stroke="currentColor"
                strokeWidth="2"
                strokeLinecap="round"
                strokeLinejoin="round"
                className="lucide lucide-git-merge"
              >
                <circle cx="18" cy="18" r="3"></circle>
                <circle cx="6" cy="6" r="3"></circle>
                <path d="M6 9v12"></path>
                <path d="m18 15-6-6"></path>
              </svg>
            </div>
          </div>
          <div className="bg-card w-full rounded-lg border p-6 shadow-sm lg:w-5/6">
            <h3 className="mb-2 text-xl font-bold">Version 1.1.0</h3>
            <time className="text-muted-foreground text-sm">
              January 15, 2023
            </time>
            <ul className="mt-4 list-disc space-y-1.5 pl-5">
              <li>Added support for custom themes</li>
              <li>Improved form validation</li>
              <li>Updated documentation</li>
            </ul>
          </div>
        </div>
      </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 }
```