@honeydeck/honeydeck 0.5.0 → 0.7.0

package/AGENTS.md

@@ -1,13 +1,13 @@
 # Honeydeck package guide
 
-This package publishes the scoped public `@honeydeck/honeydeck` npm package. It owns the CLI, runtime, Vite plugin, layouts, themes, bundled skills, canonical package docs, and runtime reference pages.
+This package publishes the scoped public `@honeydeck/honeydeck` npm package. It owns the CLI, runtime, Vite plugin, layouts, themes, bundled skills, and runtime reference pages.
 
 ## Rules
 
 - Keep public import paths as `@honeydeck/honeydeck/...`.
-- `Readme.md` is the compact package README. `docs/getting-started.md` is the canonical first-run guide. Other canonical prose docs live in `docs/*.md`; keep links in MDX form unless referring to user/Slidev source files.
-- Built-in runtime reference pages cover project-specific theme tokens, active layouts, and built-in component docs. They do not render package Markdown docs in-deck.
-- Package docs, specs, `DEVELOPMENT.md`, and skills must remain included in npm package contents.
+- `Readme.md` is the compact package README and links to the public docs site. Reader-facing docs live in `packages/docs/content/docs`.
+- Built-in runtime reference pages cover project-specific theme tokens, active layouts, and built-in component docs. They do not render public docs in-deck.
+- Specs, `DEVELOPMENT.md`, and skills must remain included in npm package contents.
 - Use suffixed `lucide-react` icon exports.
 
 ## Commands

package/DEVELOPMENT.md

@@ -166,12 +166,12 @@ Important implications:
 - CLI bin points at `./src/cli/index.ts`.
 - Vite resolves Honeydeck runtime/layout/theme/component exports from source.
 - Local development and tests use `tsx` to execute TypeScript directly.
-- `package.json#files` must include all runtime, docs, spec, development, and skill files needed by installed users and AI agents.
+- `package.json#files` must include all runtime, spec, development, and skill files needed by installed users and AI agents.
 
 Published package contents must include:
 
 - `src/` for CLI, runtime, layouts, themes, Vite plugin, and assets
-- `Readme.md` as the compact package README, `docs/getting-started.md` as the first-run guide, and `docs/*.md` for package docs and marketing-site sync
+- `Readme.md` as the compact package README with links to the public docs site
 - Root `SPEC.md` plus colocated `SPEC.md` files so AI agents and maintainers can inspect expected behavior from an installed package
 - `DEVELOPMENT.md` so maintainers can inspect development workflow, internal architecture, testing, and release expectations from an installed package
 - `skills/` so `honeydeck skill`, `npx skills add <honeydeck-repo-url> --copy`, and explicit `npx skills add <honeydeck-repo-url> --copy --skill <skill-name>` can install Honeydeck agent skills
@@ -498,7 +498,6 @@ honeydeck/
     theme/                  Base, clean, and bee CSS theme layers and colocated theme tests
     defaults.ts             Shared defaults such as default deck entry
     assets.d.ts             Static asset type declarations
-  docs/                     Canonical Markdown docs synced into the marketing docs site
   skills/                   Bundled installable agent skills
   Readme.md                 Compact package README and documentation index
   SPEC.md                   Overview and navigation map for behavior specs

package/Readme.md

@@ -14,24 +14,24 @@ npm run dev
 
 Open the local URL printed by the dev server, edit `deck.mdx`, and your slides update instantly.
 
-Decks are plain MDX files separated into slides with `---`; see the first deck example in [Getting started](docs/getting-started.md).
+Decks are plain MDX files separated into slides with `---`; see the first deck example in [Getting started](https://honeydeck.dev/docs/getting-started).
 
 ## Documentation
 
-- [Getting started](docs/getting-started.md) - first deck, first commands, and the shortest path to presenting
-- [Deeper dive](docs/deeper-dive.md) - CLI options, authoring patterns, imports, themes, architecture, and agent skills
-- [Slides](docs/slides.md) - separators, multiple files, layouts, and assets
-- [Configuration](docs/configuration.md) - deck-level and slide-level frontmatter
-- [Steps and reveals](docs/steps-and-reveals.md) - timeline, reveal groups, code steps, Magic Code, and PDF behavior
-- [Components](docs/components.md) - core Honeydeck components such as `Reveal`, `RevealWith`, `BrowserFrame`, and `Keyboard`
-- [Customization](docs/customization.md) - themes, layout sets, Tailwind tokens, custom layouts, and layout demos
-- [Navigation](docs/navigation.md) - keyboard, touch, overview mode, and URL state
-- [Mobile and touch](docs/mobile.md) - mobile controls, touch gestures, and pinch zoom
-- [Presenter mode](docs/presenter-mode.md) - notes, presenter window, sync, and mobile behavior
-- [PDF export](docs/pdf-export.md) - options, color modes, and step handling
-- [Local development](docs/local-development.md) - running Honeydeck from this repository
-- [Skills](docs/skills.md) - optional agent skills for authoring, writing, and migration help
-- [Slidev migration](docs/slidev-migration.md) - moving from Slidev with the bundled agent skill
+- [Getting started](https://honeydeck.dev/docs/getting-started) - first deck, first commands, and the shortest path to presenting
+- [Deeper dive](https://honeydeck.dev/docs/deeper-dive) - CLI options, authoring patterns, imports, themes, architecture, and agent skills
+- [Slides](https://honeydeck.dev/docs/slides) - separators, multiple files, layouts, and assets
+- [Configuration](https://honeydeck.dev/docs/configuration) - deck-level and slide-level frontmatter
+- [Steps and reveals](https://honeydeck.dev/docs/steps-and-reveals) - timeline, reveal groups, code steps, Magic Code, and PDF behavior
+- [Components](https://honeydeck.dev/docs/components) - core Honeydeck components such as `Reveal`, `RevealWith`, `BrowserFrame`, and `Keyboard`
+- [Customization](https://honeydeck.dev/docs/customization) - themes, layout sets, Tailwind tokens, custom layouts, and layout demos
+- [Navigation](https://honeydeck.dev/docs/navigation) - keyboard, touch, overview mode, and URL state
+- [Mobile and touch](https://honeydeck.dev/docs/mobile) - mobile controls, touch gestures, and pinch zoom
+- [Presenter mode](https://honeydeck.dev/docs/presenter-mode) - notes, presenter window, sync, and mobile behavior
+- [PDF export](https://honeydeck.dev/docs/pdf-export) - options, color modes, and step handling
+- [Local development](https://honeydeck.dev/docs/local-development) - running Honeydeck from this repository
+- [Skills](https://honeydeck.dev/docs/skills) - optional agent skills for authoring, writing, and migration help
+- [Slidev migration](https://honeydeck.dev/docs/slidev-migration) - moving from Slidev with the bundled agent skill
 
 ## Common commands
 

package/SPEC.md

@@ -31,7 +31,7 @@ The Honeydeck specification is distributed:
 | Runtime | Node.js CLI binary from the scoped `@honeydeck/honeydeck` package | [`src/cli/SPEC.md`](src/cli/SPEC.md) |
 | Build setup | Honeydeck-managed dev/build setup; no user `vite.config.ts` required | [`src/runtime/SPEC.md`](src/runtime/SPEC.md), [`src/vite-plugin/SPEC.md`](src/vite-plugin/SPEC.md) |
 | Styling | Explicit CSS imports, Tailwind-compatible utilities, and CSS custom properties | [`src/theme/SPEC.md`](src/theme/SPEC.md) |
-| Markdown | MDX with GitHub-flavored Markdown tables; canonical docs use `docs/*.md` | [`src/vite-plugin/SPEC.md`](src/vite-plugin/SPEC.md), [`src/remark/SPEC.md`](src/remark/SPEC.md) |
+| Markdown | MDX with GitHub-flavored Markdown tables; reader-facing docs are authored in `packages/docs/content/docs` and exported into package-local `docs/*.md` files during npm packaging | [`src/vite-plugin/SPEC.md`](src/vite-plugin/SPEC.md), [`src/remark/SPEC.md`](src/remark/SPEC.md) |
 | PDF | Rasterized slide pages matching browser rendering | [`src/cli/SPEC.md`](src/cli/SPEC.md) |
 | Syntax highlighting | Built-in code highlighting, runtime step dimming, and Magic Code transitions | [`src/remark/SPEC.md`](src/remark/SPEC.md) |
 | Icons | `lucide-react` suffixed `...Icon` component imports | [`src/SPEC.md`](src/SPEC.md) |
@@ -43,6 +43,7 @@ The Honeydeck specification is distributed:
 - Honeydeck wires the Tailwind Vite plugin internally, but Tailwind/theme CSS is only loaded when user-authored CSS imports it; generated projects install `tailwindcss` and import `./styles.css` from `deck.mdx`.
 - Generated projects use compatible semver ranges for React, Tailwind, TypeScript, and types.
 - Custom themes, layouts, and components are plain CSS/TypeScript modules; installed-package usage is handled by standard package metadata rather than by a Honeydeck-specific mechanism.
+- Published packages include generated package-local docs under `docs/*.md` plus `docs/index.json` so bundled agent skills can read version-aligned documentation from `node_modules/@honeydeck/honeydeck/docs`.
 - Icons come from `lucide-react` and must use suffixed `...Icon` component exports (for example `ChevronLeftIcon`), not inline SVG path helpers, emoji glyphs, or unsuffixed aliases.
 
 ---

package/docs/{components-browser-frame.md → browser-frame.md}

@@ -1,7 +1,11 @@
+<!-- Generated from packages/docs/content/docs/(components)/browser-frame.mdx. Do not edit by hand. -->
+
 # BrowserFrame
 
 Use `<BrowserFrame>` to show a live iframe inside a macOS-style browser window.
 
+<BrowserFramePlayground />
+
 ```mdx
 import { BrowserFrame } from '@honeydeck/honeydeck'
 

package/docs/components.md

@@ -1,22 +1,22 @@
+<!-- Generated from packages/docs/content/docs/(components)/components.mdx. Do not edit by hand. -->
+
 # Components
 
-Honeydeck core components are explicit imports from `@honeydeck/honeydeck`. They are also exported from `@honeydeck/honeydeck/components`.
+Honeydeck components are explicit MDX imports from `@honeydeck/honeydeck`. Use them when plain Markdown is not enough for timeline control, speaker notes, rich previews, or inline UI.
 
 ```mdx
 import { Reveal, RevealWith, RevealGroup, TimelineSteps, ListStyle, Keyboard, BrowserFrame, Notes } from '@honeydeck/honeydeck'
 ```
 
-Use these pages as the component reference:
-
 | Component | Use it for |
 | --- | --- |
-| [`Reveal`](components-reveal.md) | Show content at a specific slide timeline step. |
-| [`RevealWith`](components-reveal-with.md) | Show content with an existing reveal or numeric slide step without adding another step. |
-| [`RevealGroup`](components-reveal-group.md) | Reveal each direct child or list item one after another, with optional nested-list reveals. |
-| [`TimelineSteps`](components-timeline-steps.md) | Reserve timeline steps for an imported custom React component. |
-| [`ListStyle`](components-list-style.md) | Style Markdown, HTML, or JSX lists with no markers or custom markers. |
-| [`Keyboard`](components-keyboard.md) | Render semantic inline keyboard keys and shortcuts. |
-| [`BrowserFrame`](components-browser-frame.md) | Show a live iframe or fallback screenshot inside browser chrome. |
-| [`Notes`](components-notes.md) | Add formatted speaker notes for presenter mode. |
+| [`Reveal`](reveal.md) | Show content at a specific slide timeline step. |
+| [`RevealWith`](reveal-with.md) | Show content with an existing reveal or numeric slide step without adding another step. |
+| [`RevealGroup`](reveal-group.md) | Reveal each direct child or list item one after another, with optional nested-list reveals. |
+| [`TimelineSteps`](timeline-steps.md) | Reserve timeline steps for an imported custom React component. |
+| [`ListStyle`](list-style.md) | Style Markdown, HTML, or JSX lists with no markers or custom markers. |
+| [`Keyboard`](keyboard.md) | Render semantic inline keyboard keys and shortcuts. |
+| [`BrowserFrame`](browser-frame.md) | Show a live iframe or fallback screenshot inside browser chrome. |
+| [`Notes`](notes.md) | Add formatted speaker notes for presenter mode. |
 
-For broader timing concepts, see [Steps and reveals](steps-and-reveals.md). For custom components and layouts, see [Customization](customization.md).
+For timeline behavior in context, also see [Steps and reveals](steps-and-reveals.md).

package/docs/configuration.md

@@ -1,3 +1,5 @@
+<!-- Generated from packages/docs/content/docs/(core)/configuration.mdx. Do not edit by hand. -->
+
 # Configuration
 
 All settings live in YAML frontmatter — no separate config file.

package/docs/customization.md

@@ -1,3 +1,5 @@
+<!-- Generated from packages/docs/content/docs/(core)/customization.mdx. Do not edit by hand. -->
+
 # Customization
 
 Honeydeck starts with built-in layouts and a small base theme. Customize only what you need: CSS tokens, React components, or a layout map.

package/docs/deeper-dive.md

@@ -1,3 +1,5 @@
+<!-- Generated from packages/docs/content/docs/(start)/deeper-dive.mdx. Do not edit by hand. -->
+
 # Diving deeper
 
 Use this guide after the quick start when you want to understand the main Honeydeck workflows without jumping straight into every reference page.

package/docs/getting-started.md

@@ -1,3 +1,5 @@
+<!-- Generated from packages/docs/content/docs/(start)/getting-started.mdx. Do not edit by hand. -->
+
 # Getting started
 
 Honeydeck helps you create polished, interactive presentations using MDX. Write slides in Markdown, use different Layout, add React components when you need them, present using presenter mode, and export to PDF for easy sharing.

package/docs/index.json

@@ -0,0 +1,258 @@
+{
+  "generatedFrom": "packages/docs/content/docs",
+  "pages": [
+    {
+      "slug": "getting-started",
+      "title": "Getting started",
+      "description": "Getting started documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Start",
+        "Getting started"
+      ],
+      "file": "getting-started.md",
+      "sourcePath": "packages/docs/content/docs/(start)/getting-started.mdx"
+    },
+    {
+      "slug": "deeper-dive",
+      "title": "Deeper dive",
+      "description": "Deeper dive documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Start",
+        "Deeper dive"
+      ],
+      "file": "deeper-dive.md",
+      "sourcePath": "packages/docs/content/docs/(start)/deeper-dive.mdx"
+    },
+    {
+      "slug": "slides",
+      "title": "Slides",
+      "description": "Slides documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Core",
+        "Slides"
+      ],
+      "file": "slides.md",
+      "sourcePath": "packages/docs/content/docs/(core)/slides.mdx"
+    },
+    {
+      "slug": "configuration",
+      "title": "Configuration",
+      "description": "Configuration documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Core",
+        "Configuration"
+      ],
+      "file": "configuration.md",
+      "sourcePath": "packages/docs/content/docs/(core)/configuration.mdx"
+    },
+    {
+      "slug": "steps-and-reveals",
+      "title": "Steps and reveals",
+      "description": "Steps and reveals documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Core",
+        "Steps and reveals"
+      ],
+      "file": "steps-and-reveals.md",
+      "sourcePath": "packages/docs/content/docs/(core)/steps-and-reveals.mdx"
+    },
+    {
+      "slug": "customization",
+      "title": "Customization",
+      "description": "Customization documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Core",
+        "Customization"
+      ],
+      "file": "customization.md",
+      "sourcePath": "packages/docs/content/docs/(core)/customization.mdx"
+    },
+    {
+      "slug": "navigation",
+      "title": "Navigation",
+      "description": "Navigation documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Core",
+        "Navigation"
+      ],
+      "file": "navigation.md",
+      "sourcePath": "packages/docs/content/docs/(core)/navigation.mdx"
+    },
+    {
+      "slug": "mobile",
+      "title": "Mobile and touch",
+      "description": "Mobile and touch documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Core",
+        "Mobile and touch"
+      ],
+      "file": "mobile.md",
+      "sourcePath": "packages/docs/content/docs/(core)/mobile.mdx"
+    },
+    {
+      "slug": "presenter-mode",
+      "title": "Presenter mode",
+      "description": "Presenter mode documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Core",
+        "Presenter mode"
+      ],
+      "file": "presenter-mode.md",
+      "sourcePath": "packages/docs/content/docs/(core)/presenter-mode.mdx"
+    },
+    {
+      "slug": "pdf-export",
+      "title": "PDF export",
+      "description": "PDF export documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Core",
+        "PDF export"
+      ],
+      "file": "pdf-export.md",
+      "sourcePath": "packages/docs/content/docs/(core)/pdf-export.mdx"
+    },
+    {
+      "slug": "components",
+      "title": "Components",
+      "description": "Core Honeydeck components for timelines, presenter notes, browser frames, keyboard shortcuts, and styled lists.",
+      "breadcrumbs": [
+        "Components",
+        "Components"
+      ],
+      "file": "components.md",
+      "sourcePath": "packages/docs/content/docs/(components)/components.mdx"
+    },
+    {
+      "slug": "reveal",
+      "title": "Reveal",
+      "description": "Reveal documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Components",
+        "Reveal"
+      ],
+      "file": "reveal.md",
+      "sourcePath": "packages/docs/content/docs/(components)/reveal.mdx"
+    },
+    {
+      "slug": "reveal-with",
+      "title": "RevealWith",
+      "description": "RevealWith documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Components",
+        "RevealWith"
+      ],
+      "file": "reveal-with.md",
+      "sourcePath": "packages/docs/content/docs/(components)/reveal-with.mdx"
+    },
+    {
+      "slug": "reveal-group",
+      "title": "RevealGroup",
+      "description": "RevealGroup documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Components",
+        "RevealGroup"
+      ],
+      "file": "reveal-group.md",
+      "sourcePath": "packages/docs/content/docs/(components)/reveal-group.mdx"
+    },
+    {
+      "slug": "timeline-steps",
+      "title": "TimelineSteps",
+      "description": "TimelineSteps documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Components",
+        "TimelineSteps"
+      ],
+      "file": "timeline-steps.md",
+      "sourcePath": "packages/docs/content/docs/(components)/timeline-steps.mdx"
+    },
+    {
+      "slug": "list-style",
+      "title": "ListStyle",
+      "description": "ListStyle documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Components",
+        "ListStyle"
+      ],
+      "file": "list-style.md",
+      "sourcePath": "packages/docs/content/docs/(components)/list-style.mdx"
+    },
+    {
+      "slug": "keyboard",
+      "title": "Keyboard",
+      "description": "Keyboard documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Components",
+        "Keyboard"
+      ],
+      "file": "keyboard.md",
+      "sourcePath": "packages/docs/content/docs/(components)/keyboard.mdx"
+    },
+    {
+      "slug": "browser-frame",
+      "title": "BrowserFrame",
+      "description": "BrowserFrame documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Components",
+        "BrowserFrame"
+      ],
+      "file": "browser-frame.md",
+      "sourcePath": "packages/docs/content/docs/(components)/browser-frame.mdx"
+    },
+    {
+      "slug": "notes",
+      "title": "Notes",
+      "description": "Notes documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Components",
+        "Notes"
+      ],
+      "file": "notes.md",
+      "sourcePath": "packages/docs/content/docs/(components)/notes.mdx"
+    },
+    {
+      "slug": "local-development",
+      "title": "Local development",
+      "description": "Local development documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Develop",
+        "Local development"
+      ],
+      "file": "local-development.md",
+      "sourcePath": "packages/docs/content/docs/(develop)/local-development.mdx"
+    },
+    {
+      "slug": "skills",
+      "title": "Skills",
+      "description": "Skills documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Advanced",
+        "Skills"
+      ],
+      "file": "skills.md",
+      "sourcePath": "packages/docs/content/docs/(advanced)/skills.mdx"
+    },
+    {
+      "slug": "slidev-migration",
+      "title": "Slidev migration",
+      "description": "Slidev migration documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Advanced",
+        "Slidev migration"
+      ],
+      "file": "slidev-migration.md",
+      "sourcePath": "packages/docs/content/docs/(advanced)/slidev-migration.mdx"
+    },
+    {
+      "slug": "mermaid",
+      "title": "Mermaid",
+      "description": "Mermaid documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Advanced",
+        "Mermaid"
+      ],
+      "file": "mermaid.md",
+      "sourcePath": "packages/docs/content/docs/(advanced)/mermaid.mdx"
+    }
+  ]
+}

package/docs/{components-keyboard.md → keyboard.md}

@@ -1,7 +1,11 @@
+<!-- Generated from packages/docs/content/docs/(components)/keyboard.mdx. Do not edit by hand. -->
+
 # Keyboard
 
 Use `<Keyboard>` to show one key or a shortcut in slide prose.
 
+<KeyboardPlayground />
+
 ```mdx
 import { Keyboard } from '@honeydeck/honeydeck'
 

package/docs/{components-list-style.md → list-style.md}

@@ -1,7 +1,11 @@
+<!-- Generated from packages/docs/content/docs/(components)/list-style.mdx. Do not edit by hand. -->
+
 # ListStyle
 
 Use `<ListStyle>` to style Markdown, HTML, or JSX lists inside a wrapper.
 
+<ListStylePlayground />
+
 By default it removes native markers:
 
 ```mdx

package/docs/local-development.md

@@ -1,3 +1,5 @@
+<!-- Generated from packages/docs/content/docs/(develop)/local-development.mdx. Do not edit by hand. -->
+
 # Local development
 
 This guide explains how to test Honeydeck locally before it is published to npm.
@@ -19,7 +21,7 @@ npm install
 npm run dev
 ```
 
-Root `npm run dev` starts the private showcase deck package and the marketing/docs site together.
+Root `npm run dev` starts the private showcase deck package and the docs site together.
 
 To run only the showcase deck:
 

package/docs/mermaid.md

@@ -1,3 +1,5 @@
+<!-- Generated from packages/docs/content/docs/(advanced)/mermaid.mdx. Do not edit by hand. -->
+
 # Mermaid
 
 Mermaid is not part of Honeydeck core. Use it as a normal project dependency and render diagrams through a local React component that you import from your deck.

package/docs/mobile.md

@@ -1,3 +1,5 @@
+<!-- Generated from packages/docs/content/docs/(core)/mobile.mdx. Do not edit by hand. -->
+
 # Mobile and Touch
 
 Honeydeck works on phones and tablets, but mobile presentation mode behaves differently from desktop so touch gestures stay reliable.
@@ -11,7 +13,7 @@ Honeydeck works on phones and tablets, but mobile presentation mode behaves diff
 | Text selection | Slide text can be selected normally | Slide text selection is off by default; use the nav bar toggle when you need it |
 | Zoom | Browser/page zoom or normal browser controls | Honeydeck-controlled slide zoom with pinch, up to `5x` |
 | Overview | Keyboard selection and mouse clicks | Responsive fixed two-column grid |
-| Presenter mode | Current slide, next preview, notes, clock | Current slide, notes, navigation buttons; no next preview |
+| Presenter mode | Current slide, next preview, notes, clock, timer, actions; no navigation buttons | Current slide, notes, navigation buttons; no next preview |
 
 ## Tap zones
 

package/docs/navigation.md

@@ -1,3 +1,5 @@
+<!-- Generated from packages/docs/content/docs/(core)/navigation.mdx. Do not edit by hand. -->
+
 # Navigation
 
 ## Keyboard Shortcuts

package/docs/{components-notes.md → notes.md}

@@ -1,7 +1,11 @@
+<!-- Generated from packages/docs/content/docs/(components)/notes.mdx. Do not edit by hand. -->
+
 # Notes
 
 Use `<Notes>` to add presenter-only speaker notes to a slide.
 
+<NotesPlayground />
+
 ```mdx
 import { Notes } from '@honeydeck/honeydeck'
 

package/docs/pdf-export.md

@@ -1,3 +1,5 @@
+<!-- Generated from packages/docs/content/docs/(core)/pdf-export.mdx. Do not edit by hand. -->
+
 # PDF Export
 
 ## How It Works

package/docs/presenter-mode.md

@@ -1,3 +1,5 @@
+<!-- Generated from packages/docs/content/docs/(core)/presenter-mode.mdx. Do not edit by hand. -->
+
 # Presenter Mode
 
 ## Overview
@@ -18,7 +20,7 @@ Presenter mode shows the presenter everything they need while the audience sees
 │  - Remember to demo the sparkle button   │
 │  - Mention PDF export                    │
 │                                          │
-│  Slide 3/12 · Step 2/4    12:34  [Open]  │
+│  Slide 3/12 · Step 2/4  12:34  Timer 1:23  [Open] │
 └──────────────────────────────────────────┘
 ```
 
@@ -27,10 +29,12 @@ Includes:
 - Next timeline-state preview (smaller): the next step on the current slide when one exists, otherwise the next slide at step 0
 - Speaker notes for current slide
 - Slide number / step counter
-- Wall clock
+- Wall clock and an elapsed presentation timer with start, pause, continue, restart, and close/reset controls
 - Button to open audience view in a new tab/window
-- Button to cast the audience view to a secondary display when supported; the same control becomes a stop button while casting and is disabled with a hint when unsupported
-- Navigation buttons that move through the timeline while staying in presenter mode
+- Color mode toggle that also updates audience views and cast receivers
+- Blank screen toggle (`b`) that makes audience and cast views black while presenter mode shows a `Screen blanked (b)` indicator
+- Button to cast the audience view to a secondary display when supported; the same control becomes a stop button while casting. Unsupported browsers show a visibly disabled-looking button with hover/accessible text explaining why casting is unavailable.
+- Navigation buttons that move through the timeline while staying in presenter mode on mobile. Desktop presenter mode uses keyboard shortcuts instead.
 
 ## Speaker Notes
 
@@ -63,7 +67,7 @@ Content here.
 - Navigation controls button in normal presentation.
 - Direct URL: `/#/presenter/1/0`
 
-Pressing `p` opens presenter mode in the **current tab**.
+Pressing `p` opens presenter mode in the **current tab**. In presenter mode, press `p` or `Escape` to return to the audience slide view at the same slide and step.
 
 ## Navigation
 
@@ -84,12 +88,16 @@ Reveal content from later timeline steps is also shown in the `Next` preview at
 
 When no next timeline state exists, the `Next` preview shows an end-of-deck placeholder instead of trying to render a missing slide.
 
+## Blank Screen
+
+Press `b` or use the blank screen button to make the audience and cast views black. Press `b` again or use the same button to restore the slide. Audience tabs unblank automatically when presenter mode disconnects.
+
 ## Presenter/Audience Sync
 
 Presenter mode and audience view synchronize navigation via `BroadcastChannel` and, when supported, the Presentation API.
 
 - Presenter mode acts as the controller.
-- Audience view (opened from presenter mode) listens for navigation updates.
+- Audience view (opened from presenter mode) listens for navigation, color mode, and blank-screen updates.
 - The cast audience sends a `sync-request` as soon as the receiver connection appears; the presenter replies with the current slide/step in a `sync-response` so late connections resync immediately.
 - The cast audience follows presenter navigation through Presentation API receiver messages.
 - No server, internet, WebSocket, or device pairing required.

package/docs/{components-reveal-group.md → reveal-group.md}

@@ -1,3 +1,5 @@
+<!-- Generated from packages/docs/content/docs/(components)/reveal-group.mdx. Do not edit by hand. -->
+
 # RevealGroup
 
 Use `<RevealGroup>` when a short sequence should appear one item at a time.

package/docs/{components-reveal-with.md → reveal-with.md}

@@ -1,3 +1,5 @@
+<!-- Generated from packages/docs/content/docs/(components)/reveal-with.mdx. Do not edit by hand. -->
+
 # RevealWith
 
 Use `<RevealWith>` when content should appear at the same timeline step as a named `<Reveal>` or any existing numeric slide step. It never adds a new step.

package/docs/{components-reveal.md → reveal.md}

@@ -1,3 +1,5 @@
+<!-- Generated from packages/docs/content/docs/(components)/reveal.mdx. Do not edit by hand. -->
+
 # Reveal
 
 Use `<Reveal>` when content should appear at the next timeline step.
@@ -17,9 +19,9 @@ Reveals are cumulative: once visible, they stay visible while you advance throug
 | Prop | Type | Default | Description |
 | --- | --- | --- | --- |
 | `children` | `ReactNode` | — | Content to reveal. |
-| `name` | `string` | — | Optional slide-local target for [`RevealWith target="..."`](components-reveal-with.md). Must be a literal non-empty string. |
+| `name` | `string` | — | Optional slide-local target for [`RevealWith target="..."`](reveal-with.md). Must be a literal non-empty string. |
 | `className` | `string` | — | Custom class for styling or transitions. |
-| `at` | `number` | injected | Timeline step. Honeydeck injects this during compilation; author-authored values are build errors. Use [`RevealWith`](components-reveal-with.md) to sync with an existing step. |
+| `at` | `number` | injected | Timeline step. Honeydeck injects this during compilation; author-authored values are build errors. Use [`RevealWith`](reveal-with.md) to sync with an existing step. |
 | `as` | `"div" \| "span"` | injected | Wrapper element. Honeydeck injects this to keep valid MDX/HTML around block or inline content. |
 
 ## Behavior
@@ -28,6 +30,6 @@ Reveals are cumulative: once visible, they stay visible while you advance throug
 - Hidden content uses `visibility: hidden` plus `opacity: 0`, not `display: none`.
 - Nested reveals are supported.
 - Inline reveals inside paragraphs render inline wrappers.
-- Optional `name="..."` creates a slide-local target for [`RevealWith`](components-reveal-with.md).
+- Optional `name="..."` creates a slide-local target for [`RevealWith`](reveal-with.md).
 
 See [Steps and reveals](steps-and-reveals.md) for timeline ordering examples.

package/docs/skills.md

@@ -1,3 +1,5 @@
+<!-- Generated from packages/docs/content/docs/(advanced)/skills.mdx. Do not edit by hand. -->
+
 # Skills
 
 Honeydeck ships optional agent skills that help AI coding agents work with presentations more reliably. They are plain skill files bundled with the `@honeydeck/honeydeck` package, so you can install them into a deck project or into your global agent setup.
@@ -31,7 +33,7 @@ npx skills add <honeydeck-repo-url> --copy --skill slidev-migration
 
 | Skill | Use it for |
 | --- | --- |
-| `honeydeck` | Honeydeck-specific guidance for MDX decks, layouts, CSS imports, presenter notes, reveals, code steps, Magic Code, PDF export, and package docs. |
+| `honeydeck` | Honeydeck-specific guidance for MDX decks, layouts, CSS imports, presenter notes, reveals, code steps, Magic Code, PDF export, public docs, and package specs. |
 | `presentation-writing` | Framework-agnostic help with audience, storyline, slide headlines, speaker notes, timing, and review heuristics. |
 | `slidev-migration` | Migrating Slidev decks to Honeydeck, including rewriting Slidev `md magic-move` blocks to Honeydeck `md magic-code`, while preserving source files until you approve cleanup. |