Timace

Timeline

Changelog
  1. Shared librariesNowOne set of components for a whole team.Mar 2026
  2. The Air kitNo outlines, and room to breathe.Jan 2026
  3. First public releaseOct 2025
components/ui/timeline.tsx
import type { ReactNode } from "react";

// The parts every panel in this kit is made of. The corners of what is inside follow the panel's own.
const air = {
  panel: "flex w-(--tui-timeline-width) max-w-full flex-col gap-(--tui-timeline-gap) rounded-(--tui-timeline-radius) bg-(--tui-timeline-bg) p-(--tui-timeline-padding) font-(family-name:--tui-font) text-(length:--tui-timeline-font-size) leading-none text-(--tui-timeline-fg) shadow-(--tui-timeline-shadow)",
  head: "flex h-9 shrink-0 items-center justify-between gap-3 px-3 text-[0.93em] font-medium text-(--tui-timeline-muted)",
  chip: "inline-flex h-5 min-w-5 shrink-0 items-center justify-center rounded-md bg-(--tui-timeline-well) px-1.5 text-[0.8em] font-medium text-(--tui-timeline-muted) tabular-nums",
  row: "flex min-h-(--tui-timeline-row-height) items-center gap-3 rounded-[calc(var(--tui-timeline-radius)_-_var(--tui-timeline-padding))] px-3 py-2 transition-colors duration-(--tui-duration)",
  meta: "ml-auto shrink-0 pl-2 text-[0.93em] text-(--tui-timeline-muted) tabular-nums",
  detail: "text-[0.93em] leading-snug text-(--tui-timeline-muted)",
};

export interface TimelineProps {
  /** A quiet label over the rows. */
  label?: ReactNode;
  items: { title: ReactNode; /** A quieter line under the title. */ body?: ReactNode; /** When, at the end of the row. */ date: ReactNode; /** The entry happening now: its row is picked out and marked. */ current?: boolean }[];
  /** The word that marks the entry happening now. */
  now?: string;
  className?: string;
}

/**
 * What happened and when, as rows in a floating panel: what it was, a
 * quieter line, and the date at the end. The entry happening now is picked
 * out and carries a small mark.
 */
export function Timeline({ label, items, now = "Now", className }: TimelineProps) {
  return (
    <div data-slot="timeline" className={[air.panel, className].filter(Boolean).join(" ")}>
      {label && <div className={air.head}>{label}</div>}
      <ol className="m-0 flex list-none flex-col gap-(--tui-timeline-gap) p-0">
        {items.map((item, i) => (
          <li key={i} data-slot="timeline-item" aria-current={item.current ? "step" : undefined} className={air.row + (item.current ? " bg-(--tui-timeline-well)" : "")}>
            <span className="flex min-w-0 flex-col gap-1.5">
              <span className="flex items-center gap-2 font-medium">
                <span className="truncate">{item.title}</span>
                {item.current && <span className={air.chip + " bg-(--tui-timeline-accent)! text-(--tui-timeline-accent-fg)!"}>{now}</span>}
              </span>
              {item.body && <span className={air.detail}>{item.body}</span>}
            </span>
            <span className={air.meta + " self-start pt-[0.35em]"}>{item.date}</span>
          </li>
        ))}
      </ol>
    </div>
  );
}
styles/timace-ui.css
:root {
  color-scheme: light;
  --tui-bg: #ffffff;
  --tui-fg: #0a0a0a;
  --tui-muted: #f5f5f5;
  --tui-muted-fg: #737373;
  --tui-border: #e5e5e5;
  --tui-primary: #171717;
  --tui-primary-fg: #fafafa;
  --tui-ring: #a3a3a3;
  --tui-success: #16a34a;
  --tui-warning: #d97706;
  --tui-danger: #dc2626;
  --tui-radius: 8px;
  --tui-border-width: 1px;
  --tui-space: 4px;
  --tui-shadow: none;
  --tui-font: ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif;
  --tui-text: 14px;
  --tui-duration: 150ms;

  /* Timeline */
  --tui-timeline-width: 420px;
  --tui-timeline-padding: calc(var(--tui-space) * 2);
  --tui-timeline-gap: calc(var(--tui-space) * 0.5);
  --tui-timeline-radius: calc(var(--tui-radius) * 3.25);
  --tui-timeline-font-size: var(--tui-text);
  --tui-timeline-bg: light-dark(var(--tui-bg), color-mix(in oklab, var(--tui-bg) 90%, var(--tui-fg)));
  --tui-timeline-shadow: 0 0 0 1px color-mix(in srgb, var(--tui-fg) 5%, transparent), 0 2px 6px rgb(0 0 0 / 0.04), 0 16px 40px rgb(0 0 0 / 0.1);
  --tui-timeline-fg: var(--tui-fg);
  --tui-timeline-muted: var(--tui-muted-fg);
  --tui-timeline-well: color-mix(in srgb, light-dark(var(--tui-bg), color-mix(in oklab, var(--tui-bg) 90%, var(--tui-fg))) 94%, var(--tui-fg));
  --tui-timeline-accent: var(--tui-primary);
  --tui-timeline-accent-fg: var(--tui-primary-fg);
  --tui-timeline-row-height: calc(var(--tui-space) * 14);
}

.dark,
[data-theme="dark"] {
  color-scheme: dark;
  --tui-bg: #0a0a0a;
  --tui-fg: #fafafa;
  --tui-muted: #1c1c1c;
  --tui-muted-fg: #a3a3a3;
  --tui-border: #2a2a2a;
  --tui-primary: #fafafa;
  --tui-primary-fg: #171717;
  --tui-ring: #737373;
  --tui-success: #22c55e;
  --tui-warning: #f59e0b;
  --tui-danger: #ef4444;
}

Needs Tailwind CSS v4. Import the stylesheet once, after Tailwind.