# Deckard

> Next.js presentations built from editable slide patterns, with presenter tools, themes, and PDF export.

## Docs

- [Introduction](https://deckard.thebuilder.dk/introduction): Deckard is a React presentation framework for Next.js. Slides are components, the canvas is a fixed 1920x1080, and the look is a theme you can eject.
- [Quickstart](https://deckard.thebuilder.dk/quickstart): Scaffold a deck with deckard init, run it, and change a slide.
- [Slide patterns](https://deckard.thebuilder.dk/slide-patterns): Choose a complete slide recipe by what the slide needs to do, then edit the installed React source when the recipe needs to change.
- [Theme gallery](https://deckard.thebuilder.dk/themes): Every built-in Deckard theme, previewed as a real slide canvas painted by that theme's own stylesheet, switchable between light and dark.
- [Example presentation](https://deckard.thebuilder.dk/example-deck): A short engineering review built from Deckard's slide patterns, shown as a complete story rather than a component catalogue.

## Guides

- [Writing slides](https://deckard.thebuilder.dk/guides/writing-slides): The block families, when a slide earns its own file instead of an array entry, and how discoverSlides orders the modules it finds.
- [The canvas](https://deckard.thebuilder.dk/guides/the-canvas): Every slide is authored in one fixed 1920x1080 coordinate space. What that buys, what it costs, and how to handle content that does not fit.
- [Presenting](https://deckard.thebuilder.dk/guides/presenting): Keyboard navigation, the command center, the presenter window, speaker notes, step reveals, and the deck controls cluster.
- [Themes](https://deckard.thebuilder.dk/guides/themes): The built-in presets, how a deck imports one, what ejecting gives you, and what it takes to write your own.
- [Blocks and the registry](https://deckard.thebuilder.dk/guides/blocks-and-the-registry): Slide blocks install into your app as source through a shadcn registry. What the items contain, how to install them, and where they are served from today.
- [Exporting](https://deckard.thebuilder.dk/guides/exporting): PDF handouts, per-slide screenshots, and the contact sheet. All three run the deck in a browser at canvas scale.
- [Deploying](https://deckard.thebuilder.dk/guides/deploying): Build the deck, put it on Vercel or any Node host, set the public site URL, share a link to one slide, and decide who can reach the presenter window.
- [Accessibility](https://deckard.thebuilder.dk/guides/accessibility): What the runtime handles, and the parts only the author can get right. Headings inside slides, alt text, captions, contrast in a custom theme, and motion.
- [Troubleshooting](https://deckard.thebuilder.dk/guides/troubleshooting): The errors a deck actually prints, what each one means, and what to change. Search this page for the message you got.

## Reference

- [CLI](https://deckard.thebuilder.dk/reference/cli): Every deckard command and flag, with its defaults, what it prints, its exit codes, and the environment variables it reads, taken from the CLI source.
- [Deck config](https://deckard.thebuilder.dk/reference/deck-config): Every field defineDeck accepts, what it resolves them into, and the markup the deck header and footer render inside the canvas.
- [Slide metadata](https://deckard.thebuilder.dk/reference/slide-metadata): Every field on a slide definition and on a slide module, what each one does, and what the deck defaults resolve them to.
- [@thebuilder/deckard-core](https://deckard.thebuilder.dk/reference/core): Every entry point the package exposes, what each one exports, and the four Next.js route adapters an app re-exports.
- [Token contract](https://deckard.thebuilder.dk/reference/tokens): Every --slide-* custom property declared in @thebuilder/deckard-core/styles.css, its neutral default, and which part of the runtime reads it.
- [Requirements and compatibility](https://deckard.thebuilder.dk/reference/requirements): The Node, Next, React, and Tailwind versions a deck needs, which package managers work, what a presented deck asks of the browser, and which commands need Chromium.