Skip to content

view on a desktop screen for a better experience.

calendar

GraphCalendar

One month as a seven-column grid. Marked days use the accent. today is wrapped in brackets.

marked days

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

[ August 2026 ]
August 2026, today 27, marked 12, 18, 27

MDX

```
+--------------- [ GRAPHCALENDAR ] ----------------+
|                                                  |
| year: 2026                                       |
| month: 8                                         |
| today: 27                                        |
| marks: 12 18 27                                  |
|                                                  |
+--------------------------------------------------+
```

install

command

sunday start

weekStartsOn 0 matches a US calendar.

[ SHIP WEEK ]
March 2026, marked 12, 18

MDX

```
+----------------- [ SHIP WEEK ] ------------------+
|                                                  |
| year: 2026                                       |
| month: 3                                         |
| weekStartsOn: 0                                  |
| marks: day: 12 accent: true                      |
| day: true                                        |
|                                                  |
+--------------------------------------------------+
```
[ PROPS ]
PropTypeDefaultDescription
titlestringCaption. Defaults to the month name.
yearnumberFull year.
monthnumber1–12.
weekStartsOn0 | 110 is Sunday. 1 is Monday.
marksnumber[] | CalendarMark[] | "12 18"Days to accent. Pass numbers, or { day, accent }.
todaynumberDay 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.
classNamestringPassed to the outer frame.