mdeck 2.3.0 → 3.0.0

package/CHANGELOG.md

@@ -1,6 +1,17 @@
 # Changelog
 
-## 2.3.0 — unreleased
+## 3.0.0 — 2026-10-07
+
+- Every theme and palette now comes in a pack, also those that come with mdeck: `neue`, `academic`, `aurora` and `minimal` (each a theme with its palette) and the palette `lagoon`. `graphite`, close to `nordic`, moved to the theme repository as a pack of its own. They work right away and offline, and can be removed: `mdeck themes remove aurora` hides it from every deck, `mdeck themes install aurora` brings it back without the internet. A newer version from the theme repository replaces the bundled one. A deck without a theme still uses `neue`, and says so when it was removed; the last theme cannot be removed.
+- `mdeck themes install <pack>` installs for every deck by default; a slide file, a folder or `--local` installs beside that deck. Packs can require other packs (`requires = ["lagoon"]` in `pack.toml`) for palettes their themes use: installing one installs those too, and removing a pack another one needs is refused. The design page lists the packs you can install, including removed bundled ones, and removes a pack for every deck.
+- `mdeck check` no longer warns about themes installed for every deck.
+- Fewer built-in looks: mdeck now comes with the themes `neue`, `academic`, `aurora` and the new `minimal` and the palettes `swiss`, `nordic`, `neon`, `lagoon` and `graphite`. The others moved to the theme repository as packs of the same name: `duet` (with `cobalt`), `editorial` (with `terra`), `fhnw` (with `brand`), `terminal` (with `phosphor`) and `sketch` (with `pastel`), and the palettes `ember` and `forest` as `earth`. A deck that uses one gets an error that says what to run, for example `mdeck themes install duet my-talk.md`; files made with `mdeck send` or `mdeck build` keep working, because they carry their theme.
+- New theme `minimal`: nothing but the content, in the computer's own fonts (no web fonts, so it works offline), with medium weights, space instead of rules and boxes, and "Chapter 2" as a quiet label above chapter titles. Its default palette is the new `paper`: off-white and near-black with one orange accent, charcoal and a softer orange in the dark.
+- The sample deck's picture is a drawing in the palette's colours, and an SVG data URL that uses theme colours is drawn inline like an SVG file. A drawing in a picture's place now takes the space the layout gives it, like a photo, instead of pushing headings aside.
+- The launch page of `mdeck run` has a Theme editor tile under Write and learn; it opens the design page of the deck's editor.
+- The examples use built-in themes: the Python lesson `academic`, the poll and custom-layout examples `neue`, the docs home page talk `academic`.
+
+## 2.3.0 — 2026-10-07
 
 - mdeck moved to GitHub (<https://github.com/tilman-schieber/mdeck>) and is published on npmjs.com as `mdeck`: install it with `npm install -g mdeck`. The docs are at <https://gh.tschieber.de/mdeck/>. The GitLab project is archived; remove the old package with `npm uninstall -g @tilman.schieber/mdeck`.
 - New `mdeck themes`: themes and palettes from the theme repository (<https://github.com/tilman-schieber/mdeck-themes>). `search` lists the packs, `install <pack> [slides.md]` copies one into the deck's `extensions/`, or with `--global` into `~/.mdeck/extensions` for every deck; `update`, `remove` and `list` work on what is installed, and refuse to overwrite files changed by hand without `--force`. Packs hold only `extension.toml` and `styles.css`, fonts only from Google Fonts or Bunny Fonts, and are checked against the checksum the repository lists. The design page lists the repository's packs with pictures and an Install button.

package/README.md

@@ -67,11 +67,12 @@ whenever you or the assistant change the file.
 
 ## One file, any look
 
-The same slide file rendered with each of the six built-in themes. Change one
-line in the settings, or pick from the presenter view, and the whole deck
+The same slide file rendered with built-in themes and themes from the
+[theme repository](https://github.com/tilman-schieber/mdeck-themes). Change
+one line in the settings, or pick from the presenter view, and the whole deck
 repaints.
 
-<p align="center"><img src="docs/images/themes.gif" alt="The same slide cycling through the Aurora, Duet, Editorial, FHNW, Neue and Terminal themes" width="800"></p>
+<p align="center"><img src="docs/images/themes.gif" alt="The same slide cycling through six themes, built in and from the theme repository" width="800"></p>
 
 Try it yourself: the [docs home page](https://gh.tschieber.de/mdeck/)
 embeds a live deck with a theme switcher.
@@ -113,7 +114,7 @@ mdeck send talk.md           # one file to email, with a PDF inside
 ## What you get
 
 - **Layouts:** title, chapter, big statement, image and text, split, full-bleed image, and plain content slides, with points that appear one at a time.
-- **Looks:** six themes and ten colour palettes, each light or dark, changeable without touching the slides. Make your own as small `extension.toml` folders beside the deck.
+- **Looks:** four built-in themes and five colour palettes, each light or dark, changeable without touching the slides. Install more from the [theme repository](https://gh.tschieber.de/mdeck-themes/) with `mdeck themes install`, or make your own as small `extension.toml` folders beside the deck.
 - **One launch page:** `mdeck run` opens a page with a live preview, the presenter and audience views, the deck and reader views, the editor, the guides, one-click builds and PDF, the deck's check results, and for decks with a server its health and the presenter code.
 - **Presenting:** a presenter view with notes and timer, and an audience window that stays in sync.
 - **Drawing on slides:** pen with pressure, highlighter and a fading marker, with a mouse, a finger or an iPad pencil (`D`). Drawings are saved in `<deck>.drawings.json` beside the deck and appear in every view, build and PDF. An iPad can present on its own, or pair with the laptop through a QR code on the launch page while the laptop's audience window follows it.
@@ -143,12 +144,11 @@ complete folder.
 | Example | Theme | What it demonstrates |
 |---|---|---|
 | [Tour](examples/showcase/slides.md) | Aurora | Start here: each slide shows the Markdown beside what it becomes, from headings to layouts, live code, notes, drawing, a poll and sharing |
-| [Python](examples/python/slides.md) | FHNW | A real lesson: live code to try out, points revealed step by step, notes on every slide, a poll to check understanding |
-| [Poll](examples/poll/slides.md) | Duet | A join slide, then a poll, a scale, a word cloud and open questions; start it with `mdeck run slides.md --network` |
-| [Custom layouts](examples/custom-layouts/slides.md) | Terminal | A deck-local comparison design and named regions |
+| [Python](examples/python/slides.md) | Academic | A real lesson: live code to try out, points revealed step by step, notes on every slide, a poll to check understanding |
+| [Poll](examples/poll/slides.md) | Neue | A join slide, then a poll, a scale, a word cloud and open questions; start it with `mdeck run slides.md --network` |
+| [Custom layouts](examples/custom-layouts/slides.md) | Neue | A deck-local comparison design and named regions |
 
-The docs home page embeds a short talk in the Editorial theme, and the
-screenshots above show Neue.
+The docs home page embeds a short talk, and the screenshots above show Neue.
 
 ## Made at FHNW
 

package/assets/base.css

@@ -79,7 +79,10 @@ deck-stage[data-ink-hidden] .slide-ink { display: none; }
 }
 .image-pane img { width: 100%; height: 100%; object-fit: cover; display: block; }
 .image-pane .themed-picture { width: 100%; height: 100%; }
-.themed-picture:not(.themed-picture--inline) > svg { width: 100%; height: 100%; display: block; overflow: visible; }
+/* A drawing in a picture's place sizes like a photo: its box takes the space
+   the layout gives it and may shrink below the drawing's own proportions. */
+.themed-picture:not(.themed-picture--inline) { min-width: 0; min-height: 0; overflow: hidden; contain: size; }
+.themed-picture:not(.themed-picture--inline) > svg { width: 100%; height: 100%; display: block; }
 .slide-bg .slide-bg-picture { position: absolute; inset: 0; }
 .themed-picture--inline { display: inline-block; max-width: 100%; vertical-align: middle; }
 .themed-picture--inline > svg { display: block; max-width: 100%; height: auto; }

package/assets/packs/academic/pack.toml

@@ -0,0 +1,8 @@
+schema = 1
+id = "academic"
+title = "Academic"
+description = "A lecture: Source Sans and Source Serif, compact slides with the heading in a fixed place, theorem and definition blocks, booktabs tables and a footnote rule."
+version = "1.0.0"
+author = "Tilman Schieber"
+license = "MIT"
+mdeck = ">=3.0.0"

package/assets/packs/aurora/pack.toml

@@ -0,0 +1,8 @@
+schema = 1
+id = "aurora"
+title = "Aurora"
+description = "Northern lights: curtains of light in the accent colours, night-sky chapter and statement slides, frosted glass."
+version = "1.0.0"
+author = "Tilman Schieber"
+license = "MIT"
+mdeck = ">=3.0.0"

package/assets/packs/lagoon/pack.toml

@@ -0,0 +1,8 @@
+schema = 1
+id = "lagoon"
+title = "Lagoon"
+description = "Teal on warm stone, with an orange second accent."
+version = "1.0.0"
+author = "Tilman Schieber"
+license = "MIT"
+mdeck = ">=3.0.0"

package/assets/packs/minimal/minimal/extension.toml

@@ -0,0 +1,45 @@
+schema = 1
+kind = "theme"
+id = "minimal"
+title = "Minimal"
+description = "Nothing but the content: system fonts, calm type, plenty of space, no decoration. Works offline."
+# The palette this theme uses unless the deck sets one; colours come only from palettes.
+palette = "paper"
+# System fonts only: nothing to download, the same on every computer that has them.
+fonts = []
+
+[files]
+styles = "styles.css"
+
+# Type, spacing and fonts used by styles.css; colours come from the palette.
+# Deck settings (params) override these.
+[tokens]
+
+# Type scale (px) — projection-appropriate at 1920×1080
+"--fs-display" = "132px"
+"--fs-title" = "104px"
+"--fs-focus" = "84px"
+"--fs-h" = "68px"
+"--fs-sub" = "40px"
+"--fs-body" = "34px"
+"--fs-small" = "26px"
+"--fs-eyebrow" = "24px"
+
+# Spacing
+"--pad-x" = "150px"
+"--pad-y" = "84px"
+"--gap-title" = "56px"
+"--gap-item" = "26px"
+
+# Type families: the system's own
+"--font-display" = "system-ui, -apple-system, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, sans-serif"
+"--font-body" = "system-ui, -apple-system, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, sans-serif"
+
+# Settings authors can change under `params:` in the deck; each points at a token above.
+[params.fontDisplay]
+token = "--font-display"
+title = "Display font"
+
+[params.fontBody]
+token = "--font-body"
+title = "Body font"

package/assets/packs/minimal/minimal/styles.css

@@ -0,0 +1,342 @@
+/* Minimal — nothing but the content.
+   System fonts, so nothing loads and every computer shows the same faces it
+   already has; medium weights instead of heavy ones; space instead of rules,
+   bars and boxes. The accent marks emphasis and little else. Every slide
+   stays on the deck's background: the talk's rhythm comes from the type.
+   Everything takes its colours from the palette's roles, so every palette
+   works on it. */
+
+/* ─────────────────────────────────────────────
+   HEADER / FOOTER: quiet labels, no rules
+   ───────────────────────────────────────────── */
+.slide-header {
+  font-weight: 500;
+  letter-spacing: 0.02em;
+  color: var(--muted);
+}
+.slide-header .brand { color: var(--muted); }
+.slide-logo {
+  position: absolute;
+  top: var(--pad-y);
+  right: var(--pad-x);
+  height: 96px;
+  width: auto;
+  max-width: 420px;
+  object-fit: contain;
+  filter: var(--logo-filter, none);
+  transform: translateY(calc(var(--fs-eyebrow) * 0.5 - 50%));
+}
+.slide-footer {
+  font-family: var(--font-body);
+  font-size: var(--fs-small);
+  color: var(--muted);
+}
+
+/* ─────────────────────────────────────────────
+   TYPOGRAPHY HELPERS
+   ───────────────────────────────────────────── */
+.eyebrow {
+  font-family: var(--font-body);
+  font-size: var(--fs-eyebrow);
+  font-weight: 500;
+  color: var(--muted);
+  margin: 0 0 24px 0;
+}
+.display {
+  font-family: var(--font-display);
+  font-size: var(--fs-display);
+  font-weight: 600;
+  line-height: 1.05;
+  letter-spacing: -0.025em;
+  margin: 0;
+  color: var(--ink);
+  text-wrap: balance;
+}
+.title {
+  font-family: var(--font-display);
+  font-size: var(--fs-h);
+  font-weight: 600;
+  line-height: 1.1;
+  letter-spacing: -0.02em;
+  margin: 0;
+  color: var(--ink);
+  text-wrap: balance;
+}
+.subtitle {
+  font-family: var(--font-body);
+  font-size: var(--fs-sub);
+  font-weight: 400;
+  line-height: 1.3;
+  color: var(--ink-soft);
+  margin: 0;
+  text-wrap: pretty;
+}
+.body-text {
+  font-family: var(--font-body);
+  font-size: var(--fs-body);
+  line-height: 1.5;
+  color: var(--ink-soft);
+  margin: 0;
+  text-wrap: pretty;
+}
+.meta {
+  font-family: var(--font-body);
+  font-size: var(--fs-small);
+  color: var(--muted);
+}
+em { font-style: normal; color: var(--accent); }
+strong { color: var(--ink); font-weight: 600; }
+
+/* ─────────────────────────────────────────────
+   LAYOUT: TITLE — the title low on the left, nothing else
+   ───────────────────────────────────────────── */
+.slide--title .slide-body {
+  justify-content: flex-end;
+  padding-bottom: 40px;
+}
+.slide--title .display { font-size: var(--fs-display); margin: 0; max-width: 1500px; }
+.slide--title .subtitle { margin-top: 36px; max-width: 1200px; }
+.slide--title.has-image .slide-body {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  column-gap: 96px;
+  align-items: end;
+}
+.slide--title.has-image .display { font-size: calc(var(--fs-display) * 0.72); }
+.slide--title.has-image .title-image { width: 100%; height: 620px; object-fit: cover; }
+
+/* ─────────────────────────────────────────────
+   LAYOUT: CHAPTER — "Chapter 2" as a quiet label, then the title
+   ───────────────────────────────────────────── */
+.slide--chapter .slide-body {
+  justify-content: center;
+  align-items: flex-start;
+}
+/* "Chapter 2" on one line, then the title and the description below. */
+.slide--chapter .chapter-content { display: grid; grid-template-columns: auto 1fr; column-gap: 0.35em; align-items: baseline; justify-items: start; width: 100%; }
+.slide--chapter .chapter-content > * { grid-column: 1 / -1; }
+.slide--chapter .chapter-content > .chapter-meta { grid-column: 1; grid-row: 1; }
+.slide--chapter .chapter-content > .chapter-num { grid-column: 2; grid-row: 1; }
+.chapter-num {
+  font-family: var(--font-body);
+  font-size: var(--fs-eyebrow);
+  font-weight: 500;
+  color: var(--accent);
+  margin: 0;
+}
+.chapter-meta {
+  font-family: var(--font-body);
+  font-size: var(--fs-eyebrow);
+  font-weight: 500;
+  color: var(--muted);
+  margin: 0;
+}
+.slide--chapter .chapter-title {
+  font-family: var(--font-display);
+  font-size: var(--fs-title);
+  font-weight: 600;
+  line-height: 1.05;
+  letter-spacing: -0.025em;
+  margin: 24px 0 36px 0;
+  color: var(--ink);
+  max-width: 1400px;
+  text-wrap: balance;
+}
+.slide--chapter .chapter-desc {
+  font-family: var(--font-body);
+  font-size: var(--fs-sub);
+  line-height: 1.35;
+  color: var(--ink-soft);
+  max-width: 1100px;
+  margin: 0;
+}
+.slide--chapter.has-image .slide-body {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  column-gap: 96px;
+  align-items: center;
+}
+.slide--chapter.has-image .chapter-title { font-size: calc(var(--fs-title) * 0.75); }
+.slide--chapter.has-image .chapter-image { width: 100%; height: 100%; max-height: 760px; object-fit: cover; }
+
+/* ─────────────────────────────────────────────
+   LAYOUT: FOCUS — one statement, large, on the same background
+   ───────────────────────────────────────────── */
+.slide--focus .slide-body {
+  justify-content: center;
+  align-items: flex-start;
+}
+.focus-eyebrow {
+  font-family: var(--font-body);
+  font-size: var(--fs-eyebrow);
+  font-weight: 500;
+  color: var(--muted);
+  margin: 0 0 40px 0;
+}
+.focus-statement,
+.slide--focus .focus-content h1,
+.slide--focus .focus-content p {
+  font-family: var(--font-display);
+  font-size: var(--fs-focus);
+  font-weight: 500;
+  line-height: 1.15;
+  letter-spacing: -0.02em;
+  color: var(--ink);
+  max-width: 1450px;
+  margin: 0;
+  text-wrap: balance;
+}
+.focus-content { display: flex; flex-direction: column; align-items: flex-start; width: 100%; }
+.focus-attribution {
+  font-family: var(--font-body);
+  font-size: var(--fs-small);
+  color: var(--muted);
+  margin: 48px 0 0 0;
+}
+
+/* ─────────────────────────────────────────────
+   LAYOUT: IMAGE + TEXT
+   ───────────────────────────────────────────── */
+.image-pane {
+  flex: 1.1;
+  min-width: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: var(--surface);
+  overflow: hidden;
+  position: relative;
+}
+.image-placeholder { width: 100%; height: 100%; background: var(--surface); display: flex; align-items: center; justify-content: center; }
+.image-placeholder span { font-family: var(--font-body); font-size: 22px; color: var(--muted); }
+.text-pane .title { font-size: calc(var(--fs-h) * 0.9); }
+.text-pane .body-text + .body-text { margin-top: 8px; }
+
+/* ─────────────────────────────────────────────
+   LISTS — a short dash, plain numbers
+   ───────────────────────────────────────────── */
+.slide-body ul li { line-height: 1.4; padding-left: 40px; position: relative; }
+.slide-body ul li::before {
+  content: '';
+  position: absolute;
+  left: 0;
+  top: 0.72em;
+  width: 16px;
+  height: 2px;
+  background: var(--muted);
+}
+.slide-body ol li { padding-left: 52px; position: relative; }
+.slide-body ol li::before {
+  content: counter(slide-ol) '.';
+  position: absolute;
+  left: 0;
+  color: var(--muted);
+  font-variant-numeric: tabular-nums;
+}
+
+/* ─────────────────────────────────────────────
+   LAYOUT: FULL-BLEED IMAGE
+   ───────────────────────────────────────────── */
+.slide--full-bleed-image.has-overlay .slide-bg::after {
+  content: '';
+  position: absolute;
+  inset: 0;
+  background: linear-gradient(to top, rgba(0, 0, 0, 0.6), rgba(0, 0, 0, 0.1) 60%);
+}
+.slide--full-bleed-image .overlay-title {
+  font-family: var(--font-display);
+  font-size: var(--fs-h);
+  font-weight: 600;
+  line-height: 1.1;
+  letter-spacing: -0.02em;
+  color: #fff;
+  margin: 0;
+  max-width: 1300px;
+  text-wrap: balance;
+}
+
+/* ─────────────────────────────────────────────
+   GENERIC / CONTENT SLIDE
+   ───────────────────────────────────────────── */
+.slide-body h1 {
+  font-family: var(--font-display);
+  font-size: var(--fs-h);
+  font-weight: 600;
+  line-height: 1.1;
+  letter-spacing: -0.02em;
+  color: var(--ink);
+  margin: 0 0 var(--gap-title) 0;
+  max-width: 1500px;
+  text-wrap: balance;
+}
+.slide-body h2 {
+  font-family: var(--font-display);
+  font-size: var(--fs-sub);
+  font-weight: 600;
+  line-height: 1.2;
+  color: var(--ink);
+  margin: 0 0 var(--gap-item) 0;
+}
+.slide-body p {
+  font-family: var(--font-body);
+  font-size: var(--fs-body);
+  line-height: 1.5;
+  color: var(--ink-soft);
+  margin: 0 0 var(--gap-item) 0;
+  text-wrap: pretty;
+}
+
+/* ─────────────────────────────────────────────
+   CALLOUTS — a thin line on the left in the callout's colour
+   ───────────────────────────────────────────── */
+.slide-body .callout {
+  background: none;
+  border-left: 3px solid var(--rule);
+  border-radius: 0;
+  padding: 4px 0 4px 32px;
+  margin: 32px 0 0;
+  max-width: 1200px;
+}
+.slide-body .callout-tip { border-left-color: var(--accent); }
+.slide-body .callout-note { border-left-color: var(--callout-note); }
+.slide-body .callout-important { border-left-color: var(--callout-important); }
+.slide-body .callout-warning { border-left-color: var(--callout-warning); }
+.slide-body .callout-caution { border-left-color: var(--callout-caution); }
+.slide-body .callout-title { margin-bottom: 8px; }
+.slide-body .callout p { padding-left: 0; color: var(--ink); font-size: var(--fs-body); }
+/* Lecture blocks: theorems in the accent, definitions in the second */
+.slide-body :is(.callout-theorem, .callout-lemma, .callout-corollary) { border-left-color: var(--accent); }
+.slide-body .callout-definition { border-left-color: var(--accent-2); }
+
+/* ─────────────────────────────────────────────
+   CODE — on the surface, no frame
+   ───────────────────────────────────────────── */
+.code-block {
+  --code-bg: var(--surface, var(--rule));
+  --code-radius: 6px;
+  --code-size: 28px;
+  background: var(--code-bg);
+  border-radius: var(--code-radius);
+  padding: 36px 44px;
+  margin: 0;
+  overflow: hidden;
+  font-size: var(--code-size);
+  font-family: ui-monospace, "SF Mono", Menlo, Consolas, monospace;
+  line-height: 1.6;
+}
+.code-block code { font-family: inherit; font-size: inherit; background: none; padding: 0; }
+
+/* ─────────────────────────────────────────────
+   AUDIENCE QUESTIONS
+   ───────────────────────────────────────────── */
+.slide .poll-track, .slide .scale-track { background: var(--surface); }
+
+/* ─────────────────────────────────────────────
+   MATH (KaTeX)
+   ───────────────────────────────────────────── */
+.slide .katex-display {
+  font-size: var(--fs-sub);
+  margin: 40px 0;
+  overflow-x: auto;
+  overflow-y: hidden;
+}

package/assets/packs/minimal/pack.toml

@@ -0,0 +1,8 @@
+schema = 1
+id = "minimal"
+title = "Minimal"
+description = "Nothing but the content: system fonts, calm type, plenty of space, no decoration. Works offline."
+version = "1.0.0"
+author = "Tilman Schieber"
+license = "MIT"
+mdeck = ">=3.0.0"

package/assets/packs/minimal/paper/extension.toml

@@ -0,0 +1,27 @@
+schema = 1
+kind = "palette"
+id = "paper"
+title = "Paper"
+description = "Off-white paper and near-black ink, with one orange accent; charcoal and a softer orange in the dark."
+
+[light]
+"--bg" = "#fbfaf7"
+"--surface" = "#f0eee9"
+"--ink" = "#161616"
+"--ink-soft" = "#333333"
+"--muted" = "#6b6a66"
+"--rule" = "#e0ddd6"
+"--accent" = "#c2410c"
+"--accent-2" = "#1f2937"
+"--on-accent" = "#ffffff"
+
+[dark]
+"--bg" = "#151515"
+"--surface" = "#202020"
+"--ink" = "#f1efea"
+"--ink-soft" = "#d6d3cc"
+"--muted" = "#97948c"
+"--rule" = "#2e2e2c"
+"--accent" = "#fb8c4a"
+"--accent-2" = "#e7e5e0"
+"--on-accent" = "#151515"

package/assets/packs/neue/pack.toml

@@ -0,0 +1,8 @@
+schema = 1
+id = "neue"
+title = "Neue"
+description = "Swiss typography: large flush-left type, rules instead of boxes, signal red on white."
+version = "1.0.0"
+author = "Tilman Schieber"
+license = "MIT"
+mdeck = ">=3.0.0"

package/docs/reference/authoring.md

@@ -41,7 +41,7 @@ Each `---` line starts a new slide. Frontmatter is only needed when you want a s
 | Field | Default | Description |
 |---|---|---|
 | `theme` | `neue` | Theme name |
-| `palette` | _(theme default)_ | Colour palette: `lagoon`, `swiss`, `cobalt`, `nordic`, `graphite`, `terra`, `forest`, `ember`, `neon`, `phosphor`, `pastel`, or one of your own |
+| `palette` | _(theme default)_ | Colour palette: `swiss`, `nordic`, `neon`, `lagoon`, `paper`, one installed from the theme repository, or one of your own |
 | `appearance` | _(theme default)_ | `light` or `dark`: which variant of the palette the slides use |
 | `meta.title` | — | Deck title (shown in footer) |
 | `meta.author` | — | Author name (shown in footer) |
@@ -104,15 +104,15 @@ view is reachable in any build through `?view=reader`.
 |---|---|
 | `neue` | Swiss style: Inter Tight and Inter, large flush-left type, a rule across the top, square accent markers, red on white |
 | `aurora` | Northern lights: Plus Jakarta Sans, curtains of light in the palette's accents, night-sky chapter slides, frosted glass |
-| `duet` | Two voices: heavy Zilla Slab headings, DM Sans body; the two accents take turns (split fields, diagonal chapters, alternating markers) |
-| `editorial` | Magazine spread: Newsreader headlines, Lora body, drop caps and pull quotes |
-| `fhnw` | The FHNW corporate design: Inter, black on white, yellow accent areas |
-| `terminal` | A terminal session: JetBrains Mono, headings at a prompt, a blinking cursor on the title, log-line callouts, a tmux status bar; dark by default |
+| `minimal` | Nothing but the content: the system's own fonts (no web fonts, works offline), medium weights, space instead of rules and boxes |
 | `academic` | A lecture: Source Sans and Source Serif, compact type with the heading fixed at the top and the content centred below, theorem and definition blocks, booktabs tables, a footnote rule |
-| `sketch` | A sketchbook: Caveat and Patrick Hand on dotted paper, marker scribbles, circled numbers, sticky-note callouts, taped photos; a chalkboard in the dark |
 
-`mdeck list <deck>.md` lists these together with any themes kept beside
-the deck.
+More themes (duet, editorial, fhnw, terminal, sketch) are in the theme
+repository: `mdeck themes search` lists them, and
+`mdeck themes install <pack> <deck>.md` puts one beside the deck.
+
+`mdeck list <deck>.md` lists the built-in themes together with any themes kept
+beside the deck.
 
 ---
 
@@ -122,19 +122,14 @@ Each palette has a light and a dark variant; `appearance:` picks one.
 
 | Key | Light | Dark |
 |---|---|---|
-| `lagoon` | Teal on warm stone | Bright teal on teal-black |
 | `swiss` | White, black, signal red (neue's default) | Black, white, red |
-| `cobalt` | White, ultramarine, orange (duet's default) | Deep navy, luminous blue |
-| `nordic` | Ice grey, navy, steel blue | Polar night, ice blue |
-| `graphite` | Black and white, steel blue | Charcoal, light steel blue |
-| `terra` | Cream, navy, brick red (editorial's default) | Navy, cream, coral |
-| `forest` | Deep green, moss, ochre | Forest night, light green |
-| `ember` | Sand, espresso, orange | Dark brown, glowing orange |
+| `nordic` | Ice grey, navy, steel blue (academic's default) | Polar night, ice blue |
 | `neon` | White, violet, magenta (aurora's default) | Black, neon violet and pink |
-| `phosphor` | Paper printout, green, ochre (terminal's default) | Phosphor green on black, amber |
-| `pastel` | Catppuccin Latte: mauve and peach (sketch's default) | Catppuccin Mocha: pastel mauve and peach |
+| `lagoon` | Teal on warm stone | Bright teal on teal-black |
+| `paper` | Off-white, near-black, orange (minimal's default) | Charcoal, soft orange |
 
-The FHNW theme uses its own palette, `brand`, and no other.
+More palettes (cobalt, terra, phosphor, pastel, ember, forest, among others)
+are in the theme repository; install them with `mdeck themes install <pack> <deck>.md`.
 
 ---
 

package/docs/reference/claude-skill.md

@@ -40,7 +40,7 @@ to keep to the original.
 
 ```prompt
 /write-slides Rebuild kinetics-2023.pptx as a 45-minute lecture for
-second-year biology students, in German, FHNW theme. Keep the order
+second-year biology students, in German, academic theme. Keep the order
 and the figures, split the crowded slides, and add what is new in
 notes/2026-changes.md.
 ```