Skip to content
mdxcn is now part of Shadcn Labs. details

timeline

GraphTimeline

A dated list. Write `- Mar 18: Docs`, bold the current row and italicize the next. A `— note` or an indented paragraph appears under its row. For a to-do list use Check, and for work with start and end dates use Gantt.

use it
Good for steps in order, with one marked as current.
instead
A punch list is Check. A schedule with start and end is Gantt.

shipped

[ SHIPPED ]
  1. Mar 12CLI copies the files
  2. Mar 18Docs, live previews
  3. Apr 02Registry listed
<GraphTimeline title="SHIPPED">

- Mar 12: CLI copies the files
- **Mar 18: Docs, live previews**
- *Apr 02: Registry listed*

</GraphTimeline>

install

command

incident

[ INCIDENT ]
  1. 14:02p95 crossed 800ms
  2. 14:11rolled back the cache flag
  3. 14:40write the postmortem
<GraphTimeline title="INCIDENT">

- 14:02: p95 crossed 800ms
- **14:11: rolled back the cache flag**
- *14:40: write the postmortem*

</GraphTimeline>

with notes

`— note` sits under the row. Leave blank lines between items and an indented paragraph does the same.

[ NIGHT ]
  1. 14:02p95 crossed 800ms
    paged the on-call
  2. 14:11rolled back the cache flag

    Errors stopped inside a minute. Latency took ten.

  3. 14:40write the postmortem
<GraphTimeline title="NIGHT">

- 14:02: p95 crossed 800ms — paged the on-call

- **14:11: rolled back the cache flag**

  Errors stopped inside a minute. Latency took ten.

- *14:40: write the postmortem*

</GraphTimeline>
[ PROPS ]
PropTypeDefaultDescription
titlestring—Caption drawn on the top edge of the frame.
eventsTimelineEvent[]—date, label, and optional state: done, now, or next. Optional when children are Markdown.
childrenMarkdown—- **Mar 18: Docs, live previews**
palette"mono" | "duo" | "multi""mono"mono is one accent plus muted. duo paints the second series with --graph-accent-2. multi cycles three accents.
cornerstring"+"Character at each corner of the frame.
frame"box" | "corners" | "rule" | "none""box"box draws the dashed border. corners keeps only the corner marks. rule draws dashed lines above and below. none drops the border and padding, and puts the title above the content.
classNamestring—Passed to the outer frame.