Agentic Presentation Builder¶
Agentic Presentation Builder is a JSON-first presentation system that renders interactive decks with Reveal.js. It is designed for two audiences:
- human authors who want predictable presentation behavior from structured JSON
- AI agents that need machine-readable validation, warnings, and rendered audit feedback
What it does¶
- renders JSON decks into presentation-ready slides
- supports text, bullets, images, Mermaid, callouts, code blocks, and tables
- validates decks against a JSON Schema and emits non-fatal author warnings
- exposes browser-side audit data for fit scoring, overflow detection, and recommendations
- provides authoring, presentation, presenter, and audience delivery modes
- ships docs with light, dark, and system-following theme support
Core workflow¶
- Author or generate a deck in JSON.
- Run validation before opening the deck.
- Review browser audit results at presentation size.
- Present with notes, audience screen sync, or a clean deck mode.
Fast start¶
npm install
npm run dev
npm run validate -- examples/hello-world.json --json
Open:
http://localhost:3000/?presentation=./examples/hello-world.json
Documentation map¶
- Getting Started: install, run, build, and preview a deck
- JSON Authoring: deck structure, element types, and authoring rules
- Agent Workflow: CLI validation, browser audit, and automation hooks
- Presenting: modes, notes, audience screen, and shortcuts
- Schema Reference: field-level reference for the JSON contract
- Examples And Themes: shipped demos and theme usage
- Development: repo layout, commands, CI, and docs maintenance