ts-pptxPowerPoint decks from TypeScript

Write .pptx packages that open cleanly in PowerPoint, read them back, and turn one into the script that would rebuild it.

See a deck built in your browser

Start here

API reference

Write

Slides, masters and themes, charts with real embedded workbooks, tables, groups, connectors, gradients, images in shapes, OLE objects, 3D models and LaTeX maths. Emitted as OOXML, validated against the ECMA-376 schemas.

API reference

Read

Open an existing package and inspect it through typed accessors. What the reader cannot yet see is measured and published rather than guessed at.

Reading a deck

Convert to a script

Turn a .pptx into the TypeScript that would rebuild it, with a fidelity note for everything the conversion could not carry.

pptx → script

Node-first

ESM only, Node 24+, no browser and no office application in the loop. It runs in a browser too, and that lane is tested: it is simply not what the project is aimed at.

Runtime support

Install

bash

pnpm add @shbernal/ts-pptx

Start Here

Project target: what this project is optimized for.
Runtime and package support: supported package imports and dropped upstream surfaces.
Development guide: setup, source layout, and generated output rules.
Testing guide: regression, schema, package, browser, and manual verification.
Reference: public API reference and stable command surfaces.

Maintenance Focus

Keep ts-pptx focused on reusable PPTX generation behavior.
Treat package.json exports and generated declarations as the package API boundary.
Keep OOXML behavior grounded in fixtures, schema validation, and small local notes.
Keep consumer-specific deck production behavior in the downstream consumer, not this package.

Standard Verification