Gribouille - Grammar of Graphics

Showcase
, ,
1

Gribouille (French for scribble) is a new Typst package that brings Wilkinson’s grammar of graphics natively into Typst, in the spirit of ggplot2 and plotnine .

Gribouille uses cetz as backend.

The first version was released the 20th of May 2026.

Repository: GitHub - mcanouil/gribouille: Create elegant graphics with the Grammar of Graphics for Typst. · GitHub
Documentation: Gribouille

#import "@preview/gribouille:0.3.0": *

#set page(width: 16cm, height: 10cm, margin: 0cm)

#plot(
  data: penguins,
  mapping: aes(
    x: "flipper-len",
    y: "body-mass",
    colour: "species",
    fill: "species",
  ),
  layers: (
    geom-point(size: 2pt, alpha: 0.65),
    geom-smooth(method: "lm", alpha: 0.2),
  ),
  facet: facet-wrap("island", labeller: label-both()),
  scales: (scale-y-continuous(labels: format-comma()),),
  labs: labs(
    title: "Penguin Morphology by Island",
    subtitle: "Flipper length versus body mass with a per-species linear fit",
    x: "Flipper Length (mm)",
    y: "Body Mass (g)",
    colour: "Species",
    fill: "Species",
  ),
  theme: theme-minimal(),
  guides: guides(
    colour: guide-legend(position: bottom + right),
    fill: guide-legend(position: bottom + right),
  ),
  width: auto,
  height: auto,
)

showcase
showcase907×567 186 KB

16 Likes
2

Find more “real” use cases at: TidyTuesday Gallery – TidyTuesday

Sustainable Energy for All
Sustainable Energy for All2126×1116 274 KB

Whose Leave Is It Anyway?
Whose Leave Is It Anyway?1920×1008 124 KB

9 Likes
3

Every line, star, and gradient in this chart was drawn in Typst, with Gribouille plotting its own star history.
Achieve publication-quality graphics with a single toolchain, no external plotting tools needed.

Gribouille 0.4.0 soon. Full source will ships with the announcement.

Midnight-sky line chart of Gribouille's cumulative GitHub stars per day from April to June 2026, titled "Gribouille, a Rising Star". A short caption notes the chart itself was drawn with Gribouille, the grammar of graphics for Typst. A luminous gold step trail rises from zero across a long flat run labelled "Quietly built in private", lifts at a gold dashed marker labelled "Made public 17th of May", then climbs through dashed release markers tagged v0.1.0, v0.2.0 and v0.3.0 to a final amber spike of 178 stars, annotated "+99 in a day". Each daily count is drawn as a small star glyph, and a gold shooting-star fan sweeps up into the peak. The y axis counts stars in steps of 25, each tick marked with a star; the x axis spans April, May and June 2026.
Midnight-sky line chart of Gribouille's cumulative GitHub stars per day from April to June 2026, titled "Gribouille, a Rising Star". A short caption notes the chart itself was drawn with Gribouille, the grammar of graphics for Typst. A luminous gold step trail rises from zero across a long flat run labelled "Quietly built in private", lifts at a gold dashed marker labelled "Made public 17th of May", then climbs through dashed release markers tagged v0.1.0, v0.2.0 and v0.3.0 to a final amber spike of 178 stars, annotated "+99 in a day". Each daily count is drawn as a small star glyph, and a gold shooting-star fan sweeps up into the peak. The y axis counts stars in steps of 25, each tick marked with a star; the x axis spans April, May and June 2026.1890×2126 472 KB

2 Likes
4

This is very, very cool. Thanks for sharing!

2 Likes
5

Gribouille 0.4.0 on its way to Typst Universe.

Read the full announcement and get the code for the figure: Gribouille 0.4.0: Temporal Scales, Any-Glyph Markers, and a Finer Grid – Mickaël CANOUIL

2 Likes
6

This is excellent package, with impressive attention to details ! :trophy:

2 Likes
7

Gribouille 0.5.0: Native Density, and Scales Keyed by Aesthetic

Release post: Gribouille 0.5.0: Native Density, and Scales Keyed by Aesthetic – Mickaël CANOUIL)

LinkedIn: Gribouille 0.5.0 | Mickaël CANOUIL

Featured card for the Gribouille 0.5.0 release on a cream paper background. On the left, the Gribouille wordmark sits above the tagline Create elegant graphics with the Grammar of Graphics for Typst., a small orange v0.5.0 release pill, and the URL m.canouil.dev/gribouille. On the right, a slightly rotated bordered card frames a two-by-two grid of four small charts: a pattern-filled ridgeline, a violin with a beeswarm inside it, a streamgraph, and a bump chart with filled points.
Featured card for the Gribouille 0.5.0 release on a cream paper background. On the left, the Gribouille wordmark sits above the tagline Create elegant graphics with the Grammar of Graphics for Typst., a small orange v0.5.0 release pill, and the URL m.canouil.dev/gribouille. On the right, a slightly rotated bordered card frames a two-by-two grid of four small charts: a pattern-filled ridgeline, a violin with a beeswarm inside it, a streamgraph, and a bump chart with filled points.2400×1260 310 KB

#import "@preview/gribouille:0.5.0": *

#let cb = (rgb("#0072B2"), rgb("#D55E00"), rgb("#009E73"))

#let stripes = tiling(size: (6pt, 6pt))[
  #place(rect(width: 100%, height: 100%, fill: cb.at(0).lighten(60%)))
  #place(line(start: (0%, 100%), end: (100%, 0%), stroke: 1pt + cb.at(0)))
]
#let dots = tiling(size: (7pt, 7pt))[
  #place(rect(width: 100%, height: 100%, fill: cb.at(1).lighten(60%)))
  #place(dx: 2pt, dy: 2pt, circle(radius: 1.5pt, fill: cb.at(1)))
]
#let cross = tiling(size: (7pt, 7pt))[
  #place(rect(width: 100%, height: 100%, fill: cb.at(2).lighten(60%)))
  #place(line(start: (0%, 100%), end: (100%, 0%), stroke: 0.8pt + cb.at(2)))
  #place(line(start: (0%, 0%), end: (100%, 100%), stroke: 0.8pt + cb.at(2)))
]

#plot(
  data: penguins,
  mapping: aes(x: "species", fill: "species"),
  layers: (geom-bar(),),
  scales: scales(fill: scale-manual(values: (stripes, dots, cross))),
  labels: labels(
    title: "Bars You Can Read in Greyscale",
    x: "Species",
    y: "Count",
    fill: "Species",
  ),
  theme: theme-minimal(),
  width: 12cm,
  height: 7cm,
)

A bar chart of penguin counts per species, each bar filled with a different Typst tiling pattern, diagonal stripes, dots, and cross-hatch, with a legend whose swatches show the same patterns.
A bar chart of penguin counts per species, each bar filled with a different Typst tiling pattern, diagonal stripes, dots, and cross-hatch, with a legend whose swatches show the same patterns.1808×1078 409 KB

4 Likes
8

Some more real examples with Gribouille:
A horizontal lollipop chart ranking eleven modern popes by the number of encyclicals they published, ordered from Leo XIII at the top down to Leo XIV, each pope labelled with their reign years and the count at the end of its stem. Leo XIII leads with 86 in a warm accent colour, more than double the next, Pius XII with 39. The remaining popes are in muted grey: Pius XI 23, Pius X 16, John Paul II 14, Benedict XV 12, John XXIII 8, Paul VI 7, Francis 4, Benedict XVI 3, and Leo XIV with 1. A translucent funnel links the Leo XIII point to an inset column chart in the bottom-right showing his encyclicals per year across his 25-year reign, holding roughly steady between two and eight.
A diverging bar chart styled as an underwater cross-section of Irish shipwrecks by decade from 1750 to 2010. A pale surface at the top deepens through blue into the dark deep at the bottom. A waterline at zero splits each decade into wrecks that have been located, rising above it in bright teal, and wrecks with no recorded position, sinking below it in steel blue. Before 1840 almost every column plunges into the deep, peaking in the 1850s with 1,382 lost, 96 percent never located. From the 1910s the found share climbs sharply: the vermillion-outlined World War One column is the turning point, with about half of that decade's wrecks found (630). After 1950 the small columns sit almost entirely above the waterline, nearly every wreck charted. A small sinking-ship motif rests in the deep bottom-right corner.

3 Likes
9

And two more from TidyTuesday Gallery – TidyTuesday

A scatter plot of beak length along the culmen against beak depth for 92 penguin specimens covering 18 species in 6 genera. A pale grey envelope traces the outline of the whole family, and 75 small grey points inside it are the 15 species outside palmerpenguins. The 17 specimens of the palmerpenguins three are drawn larger, each species with its own colour and its own shape: coral circles for Adélie, teal triangles for chinstrap, and blue squares for gentoo. All three cluster tightly between about 53 and 69 millimetres of beak length and 15 to 22 millimetres of depth, and a dashed brown rectangle encloses exactly that range. The rectangle covers a small part of the panel: the family as a whole spans 43.5 to 110 millimetres in length and 11.9 to 31 millimetres in depth. A key inside the empty band below the rectangle names the three species with their marks and sample sizes. Three specimens at the edges of the family are labelled by name: E. minor at 43.5 millimetres long in the bottom left, E. schlegeli at 31 millimetres deep at the top, and A. patagonicus at 110 millimetres long on the far right. A callout in the upper right states that the dashed box covers 24 percent of the family's range in length and 34 percent of it in depth, roughly 8 percent of the area the other fifteen species fill.
A scatter plot of beak length along the culmen against beak depth for 92 penguin specimens covering 18 species in 6 genera. A pale grey envelope traces the outline of the whole family, and 75 small grey points inside it are the 15 species outside palmerpenguins. The 17 specimens of the palmerpenguins three are drawn larger, each species with its own colour and its own shape: coral circles for Adélie, teal triangles for chinstrap, and blue squares for gentoo. All three cluster tightly between about 53 and 69 millimetres of beak length and 15 to 22 millimetres of depth, and a dashed brown rectangle encloses exactly that range. The rectangle covers a small part of the panel: the family as a whole spans 43.5 to 110 millimetres in length and 11.9 to 31 millimetres in depth. A key inside the empty band below the rectangle names the three species with their marks and sample sizes. Three specimens at the edges of the family are labelled by name: E. minor at 43.5 millimetres long in the bottom left, E. schlegeli at 31 millimetres deep at the top, and A. patagonicus at 110 millimetres long on the far right. A callout in the upper right states that the dashed box covers 24 percent of the family's range in length and 34 percent of it in depth, roughly 8 percent of the area the other fifteen species fill.2126×1116 397 KB

Four radial dials in a row, one per species, each showing that species' year. Months run clockwise from January at the top, so the southern winter sits at the bottom, and every wedge is that month's share of the species' own records. Each dial is labelled with its species and its peak: orchid at 43 percent in September, glowworm at 30 percent in December, manta ray at 29 percent in July, and Gouldian finch at 16 percent in July. The orchid dial is dominated by one deep rose wedge reaching past the fourth ring on the left of the circle, with August and October beside it and almost nothing from December to April. The glowworm dial in green leans to the upper left, into the southern summer of November and December. The manta ray dial in ocean blue points straight down into June, July and August. The Gouldian finch dial in ochre is the most even, a small fan spread across the dry season from April to September and never rising far. Rings mark 10, 20, 30 and 40 percent.
Four radial dials in a row, one per species, each showing that species' year. Months run clockwise from January at the top, so the southern winter sits at the bottom, and every wedge is that month's share of the species' own records. Each dial is labelled with its species and its peak: orchid at 43 percent in September, glowworm at 30 percent in December, manta ray at 29 percent in July, and Gouldian finch at 16 percent in July. The orchid dial is dominated by one deep rose wedge reaching past the fourth ring on the left of the circle, with August and October beside it and almost nothing from December to April. The glowworm dial in green leans to the upper left, into the southern summer of November and December. The manta ray dial in ocean blue points straight down into June, July and August. The Gouldian finch dial in ochre is the most even, a small fan spread across the dry season from April to September and never rising far. Rings mark 10, 20, 30 and 40 percent.2126×1116 420 KB

1 Like