Decklight

Slides as a single HTML file. Written by your agent.
No build, no server, no framework.

One file, zero build

Author a single HTML file, double-click it, present.

Agent-native authoring

Describe a slide in plain English to your favorite agent, boom, done.

Diagrams & graphics

Not only bullet lists: shapes, diagrams, and full graphics, all native SVG.

Animation

Display content progressively, Magic Move between slides, and complex SVG diagrams that literally draw themselves in.

46 built-in themes

Every theme passes WCAG contrast gates and codified palette rules; diagrams and terminals reskin too. Generate yours with a keystroke.

Terminals

Real PTY recordings replayed truthfully, never a video, with the sound of the best mechanical keyboards: thocky, creamy, or clacky.

Live narration

Live text-to-speech, on the fly or cached, presents the deck by itself, perfectly in sync. Captions and pop quiz included. Or record it in your own voice, one beat at a time, and your voice steps the builds the same way.

Reviewed like code

Reviewers comment on slides and git carries it back — no accounts, no service. A comment remembers which slide it was on, so it still finds it after you insert three above. Submitting pushes the review as a branch of its own — one file, never the reviewer’s commits — and the author is told a review is waiting.

Everything is text

No binary formats anywhere, so decks diff cleanly in git and agents can read, review, and edit every byte.

The deck remembers

decklight commits as you write. H reads the history back inside the deck — every version with a live preview, what each one changed, and one keystroke to restore it.

Command palette

Press / for a Claude-style palette: every command with its shortcut, type to filter, Enter runs it. Type a number to jump to that slide.

You found the lab note. The thocky sound — the default you are hearing — was tuned strike by strike against its own reference board. Each keystroke is a dark contact click bandpassed to 680-1250Hz and rolled off above 1.8kHz, gone within 12 to 17ms: gentle and click-forward, a pop rather than a boom. Under it sits a woody case thump that rings only 5 to 9ms, and here is the detail that sells it as a real board — the thump has two pitches. Most strikes land woody at 130 to 185Hz, and about one in five drops to a deep 58 to 85Hz thock, the way a real board mixes bottom-outs with lighter keys. A second, lighter click follows 35 to 80ms later, which is the key release, and loudness spreads ~4x between a grazed key and a bottomed-out one. Synthesized live in WebAudio. No samples were harmed.

Create a deck

No install needed: npx runs the CLI straight from npm. init scaffolds a self-contained deck plus an agent skill, so Claude Code knows the authoring contract. This terminal is Decklight's own player, replaying a recorded session (press ▶ to run it again).

Describe the rest to your agent

init dropped the authoring contract next to the deck, so any agent that can edit a file can author slides — builds, SVG diagrams, animation and all. Here, Claude Code gets one prompt and edits the same HTML file:

The pitch is the product. This is the showcase deck, live, and it narrates itself: click it and it starts speaking. → advances, V toggles the voice, N changes it, ? shows all keys. Open full screen ↗

Getting the full experience

The same CLI does the rest: serve the deck live with in-browser note editing, record truthful terminal casts, bridge live narration or capture your own, take comments from a reviewer, then flatten everything into one self-contained file.

GitHub · MIT · this page and the deck ship from one decklight bundle command