Introduction

Kadal Deck is a presentation engine for people who would rather write than drag boxes. A talk is one deck.mdx file: Markdown with React components in it, split into slides at ---. The engine turns it into a web app with a presenter view, an audience page your listeners open on their phones, and a live room that keeps everyone in step.

deck.mdx  ──►  @kadal/deck/vite  ──►  one module per slide  ──►  <Deck> runtime
                                                                     │
                            the live room (Cloudflare)  ◄── WebSocket ┘
                            follow · polls · quizzes · Q&A · reactions · drawing

The pieces

Piece	What it is	Cost
`@kadal/deck`	The engine: compiler, Vite plugin, runtime, components, themes, backgrounds, presenter and audience pages, export	Free, AGPL-3.0
`@kadal/deck-vue`, `-svelte`, `-solid`, `-preact`, `-qwik`, `-angular`, `-fresh`, `-wasm`, `-python`	Framework islands: put a component from another framework on a slide	Free, AGPL-3.0
`@kadal/create-deck`	Starts a new deck: `npm create @kadal/deck@latest my-talk`	Free
`kadal-deck` CLI	`dev`, `build`, `export`, `login`, `publish`	Free
deck.kadal.cc	Publishing, the live room, analytics, workspaces	Free to $16/mo

Everything a single machine can do is free and stays free: writing, presenting, the presenter view, export to PDF, PNG and PPTX, and running your own live room. The hosted service is what you pay for when you want a link to send, a room for hundreds of phones, and the numbers afterwards.

Where to go next

New here? Getting started gets a deck running in a minute.
Writing a talk? Start with MDX slides, then clicks and animation.
Presenting soon? Read the presenter view and keys and the live room.
Publishing? The hosted service and the CLI reference.
Want everything? Open the showcase deck — every feature on one deck — and press ? for the keys.