presentation-builder

Presentation Builder

Create interactive Reveal.js presentations from JSON using the Agentic Presentation Builder. The builder transforms structured JSON definitions into professional, interactive web-based presentations with Mermaid diagrams, LaTeX math, syntax-highlighted code, and animated progressive reveals.

Pipeline Overview

1. Plan structure  -->  2. Author JSON  -->  3. Validate  -->  4. Serve & present
   (outline, theme)     (schema-driven)      (CLI validator)    (Vite dev server)

Prerequisites: get the builder CLI

The engine ships an apb command (subcommands validate, present, export, shoot). Two ways to run it; pick per situation. Pin the tag (#v0.1.8) for reproducibility.

Zero-setup (default, no clone). Run straight from the repo with bunx (or npx):

bunx github:neuromechanist/agentic-presentation-builder#v0.1.8 validate deck.json --json

Iterative authoring / offline (recommended when validating repeatedly). Use a managed cache clone so each call does not re-resolve the git package. Resolve a builder home, cloning once if needed, then run the bun run scripts from it:

APB_HOME="${APB_HOME:-$HOME/.cache/agentic-presentation-builder}"
if [ ! -d "$APB_HOME/.git" ]; then
  git clone --branch v0.1.8 https://github.com/neuromechanist/agentic-presentation-builder.git "$APB_HOME"
  (cd "$APB_HOME" && bun install)
fi
# then, e.g.:
(cd "$APB_HOME" && bun run validate -- "$(pwd)/deck.json" --json)

In the steps below, "apb <command>" means either the bunx form or bun run <command> -- from $APB_HOME. Both share one code path, so flags are identical.

Step 1: Plan the Presentation

Before writing JSON, determine:

• Topic and audience: Shapes content depth and vocabulary
• Slide count: 8-12 for a short talk, 15-25 for a full session
• Theme: academic for research talks, default for general, dark for tech demos
• Key visuals: Which slides need Mermaid diagrams, images, code blocks, or tables
• Speaker notes: Include delivery guidance for each slide