scverse · timtreis · May 12, 2026 · May 12, 2026 · May 12, 2026 · May 12, 2026
diff --git a/docs/_static/css/custom.css b/docs/_static/css/custom.css
@@ -2,3 +2,15 @@
 div.cell_output table.dataframe {
     font-size: 0.8em;
 }
+
+/* Gallery cards: normalise thumbnail height so cards line up regardless
+   of the underlying image aspect ratio. Image is contained (not cropped)
+   on a white background, centred in the slot. */
+.sd-card-img-top {
+    height: 240px;
+    width: 100%;
+    object-fit: contain;
+    background: #ffffff;
+    padding: 8px;
+    box-sizing: border-box;
+}
diff --git a/docs/_static/gallery/color_and_palette.png b/docs/_static/gallery/color_and_palette.png
diff --git a/docs/_static/gallery/visium_mouse_brain.png b/docs/_static/gallery/visium_mouse_brain.png
diff --git a/docs/gallery.md b/docs/gallery.md
@@ -24,6 +24,16 @@ The fluent `.pl` API, layering, and styling on the in-memory `blobs`
 dataset. Ideal first read.
 :::
 
+:::{grid-item-card} Colour and palettes
+:link: notebooks/tutorials/color_and_palette
+:link-type: doc
+:img-top: _static/gallery/color_and_palette.png
+
+How `color=` resolves, the v0.3.0 `groups` behaviour, and building
+perceptually well-spaced or colourblind-safe palettes with
+`make_palette` and `make_palette_from_data`.
+:::
+
 ::::
 
 ## Examples

diff --git a/docs/notebooks b/docs/notebooks
+5 −1		.github/workflows/execute.yaml
+2 −0		.gitignore
+58 −59		examples/visium_mouse_brain.ipynb
+ −		examples/visium_mouse_brain.png
+23 −1		pyproject.toml
+769 −0		tutorials/color_and_palette.ipynb
+ −		tutorials/color_and_palette.png
+11 −0		tutorials/index.md