# Drever

> Drever is a local-first presentation studio for coding agents. Approve the story, direct a live
> React and MDX draft, and keep the source and every output in ordinary files.

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/
- Documentation: https://drever.dev/docs/
- Getting started: https://drever.dev/docs/getting-started/
- Studio: https://drever.dev/docs/studio/
- AI workflows: https://drever.dev/docs/ai/
- Authoring: https://drever.dev/docs/authoring/
- Art direction and Theme contract guide: https://drever.dev/docs/themes/
- Motion: https://drever.dev/docs/motion/
- Plugin guide: https://drever.dev/docs/plugins/
- Rendered review: https://drever.dev/docs/review/
- Presenting: https://drever.dev/docs/presenting/
- Build, deploy, and export: https://drever.dev/docs/delivery/
- Complete command reference: https://drever.dev/docs/commands/
- Configuration: https://drever.dev/docs/configuration/
- 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 Codex or Claude Code:

```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/
- Spatial stories (persistent, object, and ambient Spline studies):
  https://drever.dev/showcase/spatial/
- 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 design study: 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 Code workflows, plus managed Studio adapters for other supported
  agent CLIs.
- A development-only local creation room for the common brief, adaptive questions, content-first
  Storyboard approval, an early live draft, and deck- or slide-scoped feedback.
- Managed native, ACP, and portable agent bridges that leave model credentials with the agent.
- Rendered review across exact Slide and Step states with stable diagnostics for clipping,
  overflow, overlap, contrast, safe areas, density, geometry drift, and background ownership.
- Subject-led art direction and read-only reference inspection that writes project-owned design
  code through design import.
- 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. Drever
Studio runs only during local development. Provider credentials and agent coordination code stay
with the installed agent and are excluded from production decks. The MCP server is read-only and
does not edit presentation source.