Warning
A single-file, client-side tool for comparing two PowerPoint decks (or many pairs at once), rendered with real fidelity and diffed on text, formatting, images, tables, charts, animations, transitions, speaker notes, and more — with a full reviewer workflow (approvals, comments, history) built in.
No build step, and no install required if you'd rather just open index.html directly — or install it as a CLI via npm.
- High-fidelity rendering — real
.pptxparsing (OOXML) plus@aiden0z/pptx-rendererfor pixel-accurate slide previews, with a schematic fallback if a part can't be rendered. - Deep diffing — text (word-level highlighting), fonts, color, alignment, position, shape borders, wrap, hyperlinks (text-run and shape-level), images/charts (content + position), tables (cell text, background, borders), backgrounds, animations, transitions, speaker notes (text and formatting), embedded fonts, slide master/layout inheritance, section headers.
- Deck-level comparison — not just 1:1 pairs: content-similarity alignment handles inserted/removed/reordered slides, with ADDED / DELETED / MOVED / CHANGED / IDENTICAL status tags (stackable — a slide can be both MOVED and a DUPLICATE).
- Duplicate detection — same-deck near-duplicate slides, and cross-deck duplicates (a Before slide resembling a different, unaligned After slide), with an adjustable sensitivity threshold, a performance cap for large decks, and a per-pair ignore list.
- Reviewer workflow — multiple reviewers (@handle/email + name), per-slide and per-diff Approve/Reject (with rollups), threaded comments (add/reply/delete, single and bulk), an approval history log, and scoped "clear decisions" (all / just mine / a specific reviewer / a slide range) — all backed by a single shared confirmation-modal component for every destructive action.
- Batch mode — compare many deck pairs at once (order- or filename-matched), with per-pair diff counts and cross-deck duplicate counts.
- Three-way merge — per-diff Keep-Before/Keep-After/Custom picks, a per-slide winner override, a merge-winner preview, and a real (beta) merged
.pptxexport (text/tables/background/notes/transitions; images/charts are not re-embedded). - Exports — PDF, standalone HTML report, JSON (with a
uiStateblock for round-trip re-import — merge or overwrite an in-progress session), CSV/JSON decisions, Markdown summary, Notion-flavored Markdown, Confluence wiki markup, and live push attempts to Slack (webhook), Notion (API), and Confluence (API) — the latter two typically blocked by browser CORS outside a backend proxy, and fail gracefully with the file-based export as a fallback. - Keyboard shortcuts (press
?for the full list) and a touch-friendly batch-file reorder (drag-and-drop with a touch ghost preview). - Dark mode, localStorage persistence (reviewer state; live-push credentials are opt-in, per-field).
- Self-tests — an in-browser Red/Green regression suite (
Run self-testsbutton) covering the diff engine, alignment, duplicate detection, merge logic, and a static-analysis guard against stale method references.
npx pptxdiffStarts a local server and opens the app in your default browser.
npm install -g pptxdiff
pptxdiffgit clone https://github.com/sugatoray/pptxdiff.git
cd pptxdiff
open src/pptxdiff/index.html # or just double-click it / serve the folder staticallyThe app ships with a built-in sample deck (sample-pptx.js generates it on load) so you can try every feature immediately — no files to upload. Drop in your own .pptx pair, or click Reset to sample.
Note: the app loads React, Babel, @aiden0z/pptx-renderer, and fonts from CDNs at runtime — an internet connection is required regardless of which option above you use.
git clone https://github.com/sugatoray/pptxdiff.git
cd pptxdiff
node bin/cli.js # run the CLI straight from source, no install/build stepTo exercise it as if it were installed (e.g. to test the pptxdiff command itself):
npm link
pptxdiff
npm unlink -g pptxdiff # when donebin/cli.js # npm CLI entry point — local static server + opens your browser
package.json # npm package manifest (bin, files, no runtime dependencies)
src/pptxdiff/index.html # the whole application (template + logic, self-contained)
src/pptxdiff/support.js # DC runtime the app is authored against (pinned; don't casually upgrade)
src/pptxdiff/sample-pptx.js # builds the in-browser sample/test-fixture .pptx files
docs/.scrolls/ # project memory — read docs/.scrolls/STARTER.md first if you're extending this[!note] Not Open to Contributions
Currently not accepting contributions. Please feel free to open issues at the GitHub repository.
AI Driven Development: See CLAUDE.md.
See LICENSE.