Timeline — logic2b/ui

Mar 2024
Registry shipped
50+ shadcn-compatible components served as JSON.
May 2024
Theme studio
A live two-page canvas with round-trippable preset ids.
Jul 2024
Remote MCP endpoint
The registry tools with zero local install, no shell.

import {
  Timeline,
  TimelineContent,
  TimelineDescription,
  TimelineIndicator,
  TimelineItem,
  TimelineTime,
  TimelineTitle,
} from "@/components/ui/timeline"

const events = [
  {
    time: "Mar 2024",
    title: "Registry shipped",
    description: "50+ shadcn-compatible components served as JSON.",
  },
  {
    time: "May 2024",
    title: "Theme studio",
    description: "A live two-page canvas with round-trippable preset ids.",
  },
  {
    time: "Jul 2024",
    title: "Remote MCP endpoint",
    description: "The registry tools with zero local install, no shell.",
  },
]

export default function TimelineDemo() {
  return (
    <Timeline className="w-full max-w-sm">
      {events.map((event) => (
        <TimelineItem key={event.title}>
          <TimelineIndicator />
          <TimelineContent>
            <TimelineTime>{event.time}</TimelineTime>
            <TimelineTitle>{event.title}</TimelineTitle>
            <TimelineDescription>{event.description}</TimelineDescription>
          </TimelineContent>
        </TimelineItem>
      ))}
    </Timeline>
  )
}

Installation

npx logic2b@latest add timeline

Working with an AI assistant? Copy this prompt into Claude Code, Cursor or Copilot — it carries the install steps, a no-CLI fallback and a verification checklist.

Add the "timeline" item from the logic2b ui registry (https://ui.logic2b.com) to this project. Follow every step and verify at the end.

## Steps

1. If the project has no `components.json` yet, set up logic2b ui first:

   ```bash
   npx logic2b@latest init
   ```

2. Install the item (the CLI resolves registry dependencies automatically):

   ```bash
   npx logic2b@latest add timeline
   ```

3. Install any npm dependencies the command prints.

## If the CLI is not available

Do it manually from the registry payload:

1. Fetch https://ui.logic2b.com/r/timeline.json.
2. Write every entry in `files[]` to its mapped project path (see below).
3. Repeat (recursively) for each name in `registryDependencies`.
4. Install every package listed in `dependencies` across those payloads.

## Registry reference

- Index of every item: https://ui.logic2b.com/r/index.json
- Item payload (full source): https://ui.logic2b.com/r/<name>.json
- Usage examples per item: https://ui.logic2b.com/r/demos/index.json → https://ui.logic2b.com/r/demos/<demo>.json
- Docs index for agents: https://ui.logic2b.com/llms.txt (full docs: https://ui.logic2b.com/llms-full.txt)
- Every docs page is Markdown when you append `.md` to its URL.

Registry file paths map to project paths like this:
- `ui/*` → `@/components/ui/*`
- `blocks/<name>/*` → `@/components/*`
- `charts/*` → `@/components/charts/*`
- `hooks/*` → `@/hooks/*`
- `lib/utils.ts` → `@/lib/utils.ts`
- `theme.css` → next to the project's Tailwind entry stylesheet

## Conventions (do not break these)

- Tailwind CSS v4 (CSS-first config; no tailwind.config.js needed) and React 19.
- All colors go through semantic tokens (`bg-primary`, `text-muted-foreground`,
  `border-border`, …). Never hardcode hex/oklch values in components.
- Dark mode is class-based: toggle `.dark` on `<html>`.
- Icons come from lucide-react.

## Verify before finishing

1. The dev server starts and the app renders without console errors.
2. TypeScript compiles (`tsc --noEmit` or the framework's check).
3. Components use the theme: a `<Button>` shows the primary token color,
   and toggling `.dark` on `<html>` switches the palette.

Copy into ui/timeline.tsx:

import * as React from "react"

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

/**
 * A vertical timeline for activity feeds, changelogs and process histories.
 * Composable: each `TimelineItem` holds a `TimelineIndicator` (the dot + the
 * connector line to the next item) and a `TimelineContent`. The connector is
 * hidden on the last item automatically.
 */
function Timeline({ className, ...props }: React.ComponentProps<"ol">) {
  return (
    <ol
      data-slot="timeline"
      className={cn("flex flex-col", className)}
      {...props}
    />
  )
}

function TimelineItem({ className, ...props }: React.ComponentProps<"li">) {
  return (
    <li
      data-slot="timeline-item"
      className={cn("relative flex gap-4 pb-8 last:pb-0", className)}
      {...props}
    />
  )
}

function TimelineIndicator({
  className,
  children,
  ...props
}: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="timeline-indicator"
      className={cn("relative flex flex-col items-center", className)}
      {...props}
    >
      {children ?? (
        <span className="border-primary bg-background z-10 mt-1 size-3 shrink-0 rounded-full border-2" />
      )}
      {/* Connector: fills the gap down to the next item; hidden on the last. */}
      <span className="bg-border mt-1 w-px flex-1 [li:last-child_&]:hidden" />
    </div>
  )
}

function TimelineContent({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="timeline-content"
      className={cn("flex-1 pt-0.5", className)}
      {...props}
    />
  )
}

function TimelineTime({ className, ...props }: React.ComponentProps<"span">) {
  return (
    <span
      data-slot="timeline-time"
      className={cn(
        "text-muted-foreground text-xs font-medium tabular-nums",
        className
      )}
      {...props}
    />
  )
}

function TimelineTitle({ className, ...props }: React.ComponentProps<"h3">) {
  return (
    <h3
      data-slot="timeline-title"
      className={cn("text-sm font-medium", className)}
      {...props}
    />
  )
}

function TimelineDescription({
  className,
  ...props
}: React.ComponentProps<"p">) {
  return (
    <p
      data-slot="timeline-description"
      className={cn("text-muted-foreground mt-1 text-sm", className)}
      {...props}
    />
  )
}

export {
  Timeline,
  TimelineItem,
  TimelineIndicator,
  TimelineContent,
  TimelineTime,
  TimelineTitle,
  TimelineDescription,
}

Usage

import {
  Timeline,
  TimelineItem,
  TimelineIndicator,
  TimelineContent,
  TimelineTime,
  TimelineTitle,
  TimelineDescription,
} from "@/components/ui/timeline"

<Timeline>
  <TimelineItem>
    <TimelineIndicator />
    <TimelineContent>
      <TimelineTime>Mar 2024</TimelineTime>
      <TimelineTitle>Registry shipped</TimelineTitle>
      <TimelineDescription>50+ components served as JSON.</TimelineDescription>
    </TimelineContent>
  </TimelineItem>
</Timeline>

The connector line between items is drawn by TimelineIndicator and hidden on the last item automatically. Pass your own node into TimelineIndicator (an icon, a numbered badge) to replace the default dot.

Anatomy

Part	Role
`Timeline`	Root `<ol>` list
`TimelineItem`	A single `<li>` event row
`TimelineIndicator`	The dot and the connector line to the next item
`TimelineContent`	Wraps the text column
`TimelineTime`	Muted, tabular timestamp
`TimelineTitle`	Event heading
`TimelineDescription`	Supporting copy