grid_calendar

Month-view grid with a centred month-name header, dim weekday labels, and date cells. The focused day is bolded in the today-accent colour; event days are tinted in the event-accent colour.

Accepts	Animates
calendar	no

Options

Option	Type	Required	Default	Description
week_start	"sun" | "mon"	no	"sun"	Day the week starts on. Reserved for the future — ratatui's Monthly widget always renders Sun-first; the option is accepted so configs stay forward-compatible.
marker	string	no	—	Replacement glyph for event days. Reserved — the current Monthly widget tints event cells via style only; the option is accepted for forward compatibility.

Theme tokens

Overridable via the [theme] section of your dashboard config.

Key	Description
accent_today	Calendar "today" marker.
accent_event	Calendar event marker and default scatter-plot dot colour.
text	Primary body text colour for plain renderers (text_plain, text_ascii, list_plain, animated_typewriter). The top step of the chrome ladder — brighter than text_secondary, reads as diffuse daylight on the ocean surface. Set text = "reset" to inherit the terminal's own foreground instead.

Compatible fetchers

Shape	Fetchers
calendar	basic_calendar, basic_read_store, calendar_holidays, clock, clock_almanac, clock_countdown, deariary_recent, git_age, linear_cycle, linear_issues

Preview

calendar

     April 2026             
 Su Mo Tu We Th Fr Sa       
           1  2  3  4       
  5  6  7  8  9 10 11       
 12 13 14 15 16 17 18       
 19 20 21 22 23 24 25       
 26 27 28 29 30             
                            
                            
                            

[[widget]]
id = "clock"
fetcher = "clock"
render = "grid_calendar"