An agent writes the HTML. Rikiki checks the deck, reports defects and renders screenshots for review. Fix the draft, inspect it and take the presentation into the room. The film uses on-screen text and music.
Built for the agent workflow
Would you present the first draft?
Give the agent a brief and the tools to inspect its work. You keep the final review (and the microphone).
Start here / Your brief
“Explain our incident to the engineering team. Ten minutes. Show the timeline, the root cause and what we changed. Use the attached report. Don't invent the numbers.”
Tell it who is in the room, what they need to decide and which sources to use. Leave the missing numbers blank.
A workflow your agent can follow
Give it the instructions.
The authoring skills tell your agent which components exist, how to compose them and how to check the result. Install them alongside the toolkit.
A scene is a few lines of data: cards to compare, steps in order, lanes that a gate cuts across. Rikiki measures every word in the slide's own font, lays the drawing out in your theme and plays it when the slide opens.
When an item does not fit, rikiki check names it, says which field is too long and how many characters that field holds.
Start from an editable file. Write it yourself, or let your agent work from the brief.
npx rikiki init talk.html
Review
Give the draft feedback.
Fix the reported defects. Inspect the screenshots. Check the claims against your sources.
npx rikiki check talk.html
Deliver
Send the presentation.
Present with notes, send an offline HTML file, or hand over a PDF. Keep the editable source.
npx rikiki bundle talk.html
The setup guide covers the extra dependencies (the browser and bundler need installing too).
Optional modules
Bring only the pieces the deck needs.
The ~43 KB initial load excludes these modules. In a source deck, imported modules load when their feature starts. A standalone bundle packages them locally.
Measured from this build. Sizes shown after gzip compression.
A deck is plain HTML, so your own custom elements or a stylesheet can sit next to it and load with a <script type="module"> tag, with no build step. Read the API reference
HTML and CSS are enough. Write the supplied custom elements, then change CSS variables for your brand. Lit, a small Web Components library, is an implementation detail; deck authors do not write Lit classes or templates.
Can I write my slides in Markdown?+
Not as a deck format, and that is a design choice: a slide is an HTML custom element, so the file you write is the file the browser runs, with no custom syntax or --- separator to learn. Inside a slide, the core <deck-md> component renders standard GitHub-flavoured Markdown, including headings, lists, links, tables, code blocks and images, plus one ::: cards fence that expands into a card grid. A deck can mix HTML slides and Markdown bodies freely.
Can I print my deck to PDF?+
Yes, two ways. From the browser, print with backgrounds on: the deck carries its own print stylesheet, so every slide becomes one page at the deck’s canvas size, chrome hidden. Or run rikiki export deck.html --output deck.pdf, which drives a headless Chromium and waits for fonts and diagrams first. The CLI needs Playwright, an optional peer dependency.
Is there a presenter mode with notes?+
Yes. Wrap notes in <deck-notes> inside any slide, then press P during the talk. A popup opens with the current and next slide, the notes, a timer and a slide counter. The two windows synchronize locally through BroadcastChannel; no external service is involved.
How do I theme a deck for my brand?+
Copy themes/rikiki.css, change the palette and semantic CSS variables, then link your file instead of the default theme. For one component instance, override its documented --deck-* variables directly.
Can I embed a deck in documentation or training?+
Yes. Put <deck-root> in a page and add autoplay loop swipe for a touch-friendly carousel with the same ~43 KB initial load. Keyboard input stays scoped to the deck while it has focus.
What does rikiki check report?+
rikiki check loads every slide in Chromium and reports structural, runtime, timing and visual-layout risks. It does not test contrast, focus order or screen-reader output, so keep an accessibility review in your release process.
Is a deck accessible?+
The example decks are tested with axe in Chromium, Firefox and WebKit, and a serious or critical violation fails the suite. The overview opens, moves and picks a slide with the keyboard alone, every on-screen control is a real focusable button, a slide change is announced to assistive technology through a live region, and no slide animates under prefers-reduced-motion. rikiki export writes a tagged PDF with one bookmark per slide. Those tests cover the shipped examples and the runtime, not the contrast or the reading order of the content you write.
What requires Node.js?+
Presenting a deck? A browser is enough.
Creating and checking one? The CLI needs Node.js. Supported versions: 20.19+ (20.x) or 22.12+.
Browser checks, screenshots and PDF
check, render and export use Playwright and Chromium.
Browser tooling
npmi-Dplaywrightnpxplaywrightinstallchromium
Standalone HTML
bundle and init --standalone use the optional bundler.
Bundler
npmi-Drolldown
Which browsers are tested?+
The base rendering, navigation, scaling and offline-bundle contract is tested in Chromium, Firefox and WebKit. Presenter notes, previews and reveal steps also work in Firefox and Safari. Automatic placement on a second screen uses Chromium’s Window Management API. CLI PDF export uses headless Chromium.
Why is there no build step and no custom syntax?+
There is no build step on the author side: the served folder contains the runtime, so you open index.html from any static HTTP server and it runs. Everything rests on Web standards, namely Custom Elements, Shadow DOM, ES Modules and CSS custom properties, with a thin component library rather than an application framework underneath. The source is readable HTML, so a slide reads the same in your editor and in the browser. Features beyond the core, such as presenter mode, transitions or syntax highlighting, are opt-in modules you import only when a deck needs them.
Who maintains it, and what is the release status?+
The project is developed by Cédric Chariere Fiedler and released under the MIT license; source, issues and merge requests live at gitlab.com/tordu-jardin/rikiki. Version 0.8.0 shipped on 28 October 2026, and from that tag a breaking change means a major version bump. The changelog lists every release.