Timeline Year Archive

Blog42: Timeline Year Archive

A vertical archive that groups posts by year and month parsed from each post's date string, rendering years in descending order with a calendar-icon header and a bordered timeline rail, under which each month lists its posts as compact next/link rows showing the title and a short month/day date plus a hover-revealed chevron.

Installation

Swap YOUR_EMAIL and YOUR_KEY for the email and license key on your account. Find your license key on your account page.

Radix flavor

npx shadcn add "https://ui.beste.co/r/blog42?email=YOUR_EMAIL&license_key=YOUR_KEY"

Base UI flavor

npx shadcn add "https://ui.beste.co/r-base/blog42?email=YOUR_EMAIL&license_key=YOUR_KEY"

This installs the block to components/beste/block/blog42.tsx, plus the badge shadcn/ui primitive it uses for the section eyebrow badge.

Quick start

The installed file exports blog42Demo alongside the block: the exact props behind the preview above. Spread it to get a working year archive in one line.

import { Blog42, blog42Demo } from "@/components/beste/block/blog42";

export default function Page() {
  return <Blog42 {...blog42Demo} />;
}

Then replace the demo with your own props. Written out, a trimmed setup looks like this:

import { Blog42 } from "@/components/beste/block/blog42";

export default function Page() {
  return (
    <Blog42
      badge={{ label: "Archive", variant: "default" }}
      heading="Blog Archive"
      description="Browse articles by date."
      posts={[
        { title: "The Future of Web Development", date: "January 28, 2026", href: "/blog/future-of-web" },
        { title: "Year in Review", date: "December 28, 2025", href: "/blog/year-in-review" },
      ]}
    />
  );
}

Props

type BlogPost = {
  title: string;
  date: string;
  href?: string;
};

Behavior notes

• Grouping is derived entirely from each post.date by passing it to new Date(...), so dates must be parseable strings (e.g. "January 28, 2026"); a post with a falsy date is skipped from the reduce, and an unparseable one yields NaN year/"Invalid Date" labels rather than an error.
• Years are sorted numerically descending via Object.keys(archive).sort((a, b) => Number(b) - Number(a)), but months within a year keep their first-seen insertion order and are not chronologically sorted, so unordered input can produce out-of-order months.
• The row date shown next to each title is reformatted to short month and numeric day (toLocaleDateString("en-US", { month: "short", day: "numeric" })), independent of the long month used for the group header.
• Each row is a next/link pointing at post.href, falling back to "#" when href is omitted; there are no click callbacks, selection state, or internal useState, the block is purely presentational.
• The entire header block (badge, heading, description) only renders when at least one of badge, heading, or description is provided; each of the three is individually conditional as well.
• The trailing ChevronRight is decorative and hidden by default (opacity-0), fading in only on row hover via the group/blog42 hover group, and titles are clamped to a single line with line-clamp-1.