# Drever

> Drever is an open-source, local-first React and MDX framework for clear, expressive, interactive
> slides created with AI.

Drever uses readable MDX as its authoritative source. A root-level `---` line separates slides.
Authors use Markdown for ordinary content, built-in `Step` for deliberate progressive disclosure,
`Note` for speaker-only guidance, and React components when an idea needs interaction.

One project produces:

- a live audience presentation with clean, exact slide and Step URLs;
- Speaker View with notes, current/next previews, rehearsal timing, and focus tools;
- Document View with every reveal in searchable reading order;
- a static production website;
- deterministic PDF output at final states or every exact Step stop.

## Start

- One-step AI bootstrap: https://drever.dev/prompt.md
- Changelog: https://drever.dev/changelog/
- Real post-release Codex smoke runs: https://drever.dev/release-smoke/
- Documentation: https://drever.dev/docs/
- Getting started: https://drever.dev/docs/getting-started/
- Configuration: https://drever.dev/docs/configuration/
- Authoring: https://drever.dev/docs/authoring/
- Motion: https://drever.dev/docs/motion/
- Art direction and Theme contract guide: https://drever.dev/docs/themes/
- Plugin guide: https://drever.dev/docs/plugins/
- Presenting: https://drever.dev/docs/presenting/
- Build, deploy, and export: https://drever.dev/docs/delivery/
- AI workflows: https://drever.dev/docs/ai/
- Credits: https://drever.dev/docs/credits/
- Showcase of complete stories, focused capabilities, and art directions:
  https://drever.dev/showcase/
- GitHub: https://github.com/Zhangdroid/drever

For an AI agent, start with:

> Fetch and follow https://drever.dev/prompt.md. Brief: [describe what you want to present, with any
> audience, outcome, source, or delivery constraints you know].

Manual project creation:

```sh
npm create drever@latest my-slides
```

Open directly in an agent:

```sh
npm create drever@latest my-slides -- --open codex
npm create drever@latest my-slides -- --open claude
```

## Live showcase

Catalog: https://drever.dev/showcase/

### Complete stories and capability studies

- Product tour: https://drever.dev/showcase/product/
- Feature gallery: https://drever.dev/showcase/features/
- Motion stories: https://drever.dev/showcase/motion/
- Room scenes (incubating source study): https://drever.dev/showcase/scenes/
- Architecture: https://drever.dev/showcase/architecture/
- Minimal reference: https://drever.dev/showcase/basic/

### Art-direction studies

- Basic: https://drever.dev/showcase/design/basic/
- Editorial: https://drever.dev/showcase/design/editorial/
- Studio: https://drever.dev/showcase/design/studio/
- Fieldnote: https://drever.dev/showcase/design/fieldnote/
- Atlas: https://drever.dev/showcase/design/atlas/
- Ledger: https://drever.dev/showcase/design/ledger/
- Cinema: https://drever.dev/showcase/design/cinema/
- Construct: https://drever.dev/showcase/design/construct/

Each demo is a complete static Drever build. Append `/speaker` for Speaker View or `/document` for
Document View. Audience paths such as `/5/2` select an exact slide and sparse Step.

## Implemented capabilities

- MDX compilation with protected `---` slide boundaries.
- Sparse, addressable Step state.
- Built-in Note and semantic MotionGroup primitives.
- Motion intents: focus, replace, compare, stagger, and continuity.
- A live Stage background and stable named foreground above document View Transitions.
- Audience toolbar, slide search, fullscreen, black/white pause screens, and canonical link copying.
- Laser, Pen, and Highlighter in audience and speaker views.
- Source accessibility preflight with human and stable JSON diagnostics.
- Project-local Codex and Claude skills.
- JSON authoring context and local live-position commands.
- Optional dependency-free, read-only MCP server.
- Default build-time GFM, Shiki, and reset-free Tailwind CSS.
- Opt-in build-time LaTeX through KaTeX.
- Opt-in `@drever/plugin-charts` for accessible bar, line, area, dot, and donut SVG plus animated
  presentation metrics, without a general-purpose charting dependency.
- Opt-in `@drever/plugin-media` for surface-aware YouTube embeds.
- Eight official design studies, implemented as deterministic Theme contracts: Basic, Editorial,
  Studio, Fieldnote, Atlas, Ledger, Cinema, and Construct.

## Important boundaries

Drever is under active development and its public API is not yet stable. Mermaid is intentionally
deferred. Drever does not currently claim a hosted editor, real-time collaboration, cross-device
remote control, PPTX/Keynote import or export, video export, or a visual layout oracle. The MCP
server is read-only and does not edit presentation source.