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

timer

GraphTimer

Time since a moment, how long ago it was, or the current time, updated every second. Write the start inside the tag: `2026-09-01T09:00Z — since deploy`.

use it
Good for uptime, last deploy, or a clock in the corner.
instead
Time left until a date is Countdown. A static number is Stat.

incident

The instant, then the caption. `kind` stays a prop.

[ INCIDENT ]

00:00:00

api

timer
<GraphTimer title="INCIDENT" kind="elapsed">

2026-08-27T08:00:00Z — api

</GraphTimer>

install

command

last deploy

How long since the last deploy.

[ SHIPPED ]

0s ago

last deploy

timer
import { GraphTimer } from "@/registry/default/graph-timer/graph-timer"

<GraphTimer
  title="SHIPPED"
  kind="ago"
  at="2026-08-27T12:00:00Z"
  caption="last deploy"
/>

local

The time of day, updating every second.

[ LOCAL ]

00:00:00

timer
import { GraphTimer } from "@/registry/default/graph-timer/graph-timer"

<GraphTimer
  title="LOCAL"
  kind="clock"
/>
[ PROPS ]
PropTypeDefaultDescription
titlestring—Caption drawn on the top edge of the frame.
kind"elapsed" | "ago" | "clock""elapsed"elapsed counts up from at. ago is relative. clock is the time of day.
atDate | number | string—Start time for elapsed and ago. A date, timestamp, or ISO string. Optional when children are Markdown.
childrenMarkdown—2026-09-01T09:00Z — since deploy
captionstring—Line under the number.
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.