Diagrams as text
Mermaid diagrams live in the deck, take its colours in light and dark, and change in the same pull request as the code. PlantUML works too.
Use cases / Team demos and reviews
Sprint demos and engineering reviews
Keep the review deck in the repository it describes. Draw the architecture in Mermaid, run the code on the slide, and publish a fresh link from CI on every merge.
Why it fits
What Kadal Deck gives you here
Run it on the slide
Monaco editors with a Run button: JavaScript and TypeScript in a Web Worker, Python with Pyodide, or your own runner for SQL or an API.
Published by CI
An API token lets a GitHub Action publish the deck on every merge, so the link in the calendar invite is always current.
A shared workspace
The Team plan gives two people one workspace and its decks; more people cost $8 a month each, billed yearly.
The deck
A real one, ready to copy
A demo deck: the sprint's title, an architecture diagram in Mermaid, and a TypeScript block the audience can watch run. It passes kadal-deck check as it stands.
---
title: Search, sprint 14
theme: stack
---
# Search, sprint 14
What shipped, what broke, what's next
---
## How a query flows now
```mermaid
flowchart LR
A[Browser] --> B[Edge cache]
B -->|miss| C[Search API]
C --> D[(Index)]
C --> E[Ranker]
```
<Notes>The edge cache is new this sprint: 70% of queries stop there.</Notes>
---
## Try it
```ts {monaco-run}
const words = ["tide", "harbour", "tide", "port"];
const counts = Object.groupBy(words, (w) => w);
console.log(Object.keys(counts).length, "distinct words");
```Step by step
From an empty folder to the room
-
Add a deck to the repository
A docs/demo folder with deck.mdx is enough; the snippet is a start.
-
Publish from CI
Create an API token in the dashboard, store it as a secret, and run publish in a workflow.
npx kadal-deck publish --slug sprint-14pnpm exec kadal-deck publish --slug sprint-14yarn kadal-deck publish --slug sprint-14bunx kadal-deck publish --slug sprint-14 -
Present on the call
The desktop app's share window shows the room your slides and never your notes.
-
Keep it
Every version stays in the deck's history, so last sprint's demo is still one click away.
Read next
In the docs
Other uses: Slides in Markdown · Conference talks · Lectures and teaching · Pitch decks · Workshops