When work runs, as bars on days, by milestone.
Every shadcn style · one file
v2.1 · Updated Oct 21pnpm dlx shadcn@latest add @notchset-pro/timelinepnpm dlx shadcn@latest add @notchset-pro/timelineNeeds your registry key. Every components.json style gets the same files.
Works with React 18.3 or 19 on Tailwind CSS v4, in any shadcn project. What's tested
The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.
Import it and pass your content. The props that matter most are listed next.
"use client";
import * as React from "react";
import { StatusGlyph } from "@/components/ui/notchset/status-glyph";
import { Timeline } from "@/components/ui/notchset/blocks/timeline";
const START = [
{ id: "RP-49", group: "beta", title: "Recalculate ETA when a job runs long", start: -6, end: -1, started: true, late: true },
{ id: "RP-57", group: "beta", title: "Undo for route edits", start: -3, end: 0, started: true },
{ id: "RP-60", group: "launch", title: "Explain why a stop moved", start: 4, end: 7 },
];
export default function TimelineDemo() {
const [rows, setRows] = React.useState(START);
const [open, setOpen] = React.useState<string | null>(null);
return (
<div className="flex w-full flex-col gap-2">
<Timeline
label="Route planner v2: open work by milestone"
groups={[
{ key: "beta", label: "Planner beta", due: { day: 10, label: "Oct 30" } },
{ key: "launch", label: "Public launch" },
]}
rows={rows.map((r) => ({ ...r, glyph: <StatusGlyph status={r.started ? "doing" : "todo"} label={r.title} /> }))}
from={-10}
to={20}
ticks={[-8, -1, 6, 13, 20].map((day) => ({ day, label: `Day ${day}` }))}
dayName={(d) => (d === 0 ? "today" : d < 0 ? `${-d} days ago` : `in ${d} days`)}
onOpen={setOpen}
onMove={(id, by) => setRows((rs) => rs.map((r) => (r.id === id ? { ...r, end: r.end + by, start: r.started ? r.start : r.start + by } : r)))}
/>
{open && <p className="m-0 px-[var(--ns-gutter)] text-[length:var(--ns-text-small)] text-[var(--ns-ink-3)]">Opened {open}</p>}
</div>
);
}This example also uses Status glyph. This command installs them with it, so the example pastes as it is:
pnpm dlx shadcn@latest add @notchset-pro/timeline @notchset/status-glyphcomponents/ui/notchset/blocks/timeline.tsx
This component is included with Pro.
Try the live preview above. Get Pro to install the source.
groups–
TimelineGroup[]Required.
rows–
TimelineRow[]Required.
from–
numberRequired.
to–
numberRequired.
ticks–
{ day: number; label: string }[]the axis's labels (each week's Monday), by day
dayName–
(day: number) => stringwhat a day is called, for a bar's words ("Mon, Oct 19")
onMove–
(id: string, by: number) => boolean | voidRequired.
onResize–
(id: string, edge: "start" | "end", by: number) => boolean | voidone end moved (the start or the end), by days; refuse with false
onOpen–
(id: string) => voidRequired.
links[]
{ from: string; to: string }[]what waits on what: drawn for the bar in focus
dayWidth26
numberpixels per day: 26 for weeks, about 10 for months
today0
numberchange it to scroll back to today
label–
stringRequired.
Give your coding assistant the Markdown guide instead of screenshots.
https://notchset.dev/api/mcp (setup)v2.1.0 · 2026-10-21
New: work on a calendar, with today running under the bars and their titles.
v2.0.0 · 2026-10-13
Released with the Notchset system.
The same file, at work in a finished app. Open it live and find it on its pages.
Pro is in early access.