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.
- 4freeze tokens
- 12registry listed
- [18]docs go live
- 27postmortem due
<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, 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.
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 }]}
/>| Prop | Type | Default | Description |
|---|---|---|---|
| title | string | — | Caption. Defaults to the month name. |
| year | number | — | Full year. |
| month | number | — | 1–12. |
| weekStartsOn | 0 | 1 | 1 | 0 is Sunday. 1 is Monday. |
| marks | number[] | CalendarMark[] | "12 18" | — | Days to accent. Pass numbers, or { day, accent }. Optional when children are Markdown. |
| children | Markdown | — | - 12: launch - **18: today** |
| today | number | — | 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. |
| corner | string | "+" | 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. |
| className | string | — | Passed to the outer frame. |