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

calendar

GraphCalendar

One month as a seven-column grid. Write `- 12: launch` to mark a day; marked days use the accent and their labels are listed under the month. Today is shown in brackets, and a bold item sets it.

use it
Good for one month with a few days marked.
instead
A year of activity is Activity.

with notes

A list of `day: label`. Labels list under the month. Bold is today.

[ March 2026 ]
  • 4freeze tokens
  • 12registry listed
  • [18]docs go live
  • 27postmortem due
March 2026, today 18, marked 4, 12, 18, 27
<GraphCalendar year={2026} month={3}>

- 4: freeze tokens
- 12: registry listed
- **18: docs go live**
- 27: postmortem due

</GraphCalendar>

install

command

marked days

month is 1–12. today is passed in so render stays stable.

[ August 2026 ]
August 2026, today 27, marked 12, 18, 27
import { GraphCalendar } from "@/registry/default/graph-calendar/graph-calendar"

<GraphCalendar year={2026} month={8} today={27} marks="12 18 27" />

sunday start

weekStartsOn 0 matches a US calendar.

[ SHIP WEEK ]
March 2026, marked 12, 18
import { GraphCalendar } from "@/registry/default/graph-calendar/graph-calendar"

<GraphCalendar
  title="SHIP WEEK"
  year={2026}
  month={3}
  weekStartsOn={0}
  marks={[{ day: 12, accent: true }, { day: 18 }]}
/>
[ PROPS ]
PropTypeDefaultDescription
titlestring—Caption. Defaults to the month name.
yearnumber—Full year.
monthnumber—1–12.
weekStartsOn0 | 110 is Sunday. 1 is Monday.
marksnumber[] | CalendarMark[] | "12 18"—Days to accent. Pass numbers, or { day, accent }. Optional when children are Markdown.
childrenMarkdown—- 12: launch - **18: today**
todaynumber—Day of the month to wrap in brackets. Pass it in.
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.