grid_heatmap

GitHub-contribution-style 2D grid of square-ish cells bucketed into five intensity levels from the heatmap palette, with optional column labels along the top. Right-aligns when the grid is wider than the slot so the most recent columns stay visible.

Accepts	Animates
heatmap	no

Options

Option	Type	Required	Default	Description
cell_char	single character (e.g. "■", "●", "▮")	no	"■"	Glyph painted at every cell. Strings longer than one visible character are truncated to the first glyph.
align	"left" | "center" | "right"	no	"left"	Horizontal alignment of the heatmap inside the slot when the grid is narrower than the available width.

Theme tokens

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

Key	Description
palette_heatmap	5-step intensity gradient for grid_heatmap (level 0 → level 4). TOML array.
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
heatmap	basic_heatmap, basic_read_store, git_blame_heatmap, git_commits_activity, github_contributions

Preview

heatmap

■ ■ ■ ■ ■ ■ ■                           
■ ■ ■ ■ ■ ■ ■                           
■ ■ ■ ■ ■ ■ ■                           
                                        
                                        
                                        

[[widget]]
id = "git_blame_heatmap"
fetcher = "git_blame_heatmap"
render = "grid_heatmap"