moda-deck-pptx

moda-deck-pptx

PREREQUISITE — load moda-core once per session (step-0, write contract, free/metered map). Already loaded? Skip ahead. If you cannot load it, the non-negotiables: run moda doctor --json before anything; moda brand list before creating; writes that pin a revision use your last read's — on stale_revision, re-read and retry once (it heals); send the canvas link the moment it exists; stuck or failed? moda ask "<question>" — free and fast, never guess.

Sizes and defaults

Thing	Value	Notes
Import	`moda canvas import-pptx [file.pptx]`	FREE, un-billed, async — the verb polls to completion
Result	one canvas, one page per slide	slide size is preserved from the file
Round trip	`moda export … --format pptx`	native shapes and text layers, not screenshots
Data law	every source string and number survives verbatim	a cleanup that loses data is a failure

Import takes a local path or a durable file_… ref. Nothing is generated and nothing is charged; the import is the cheapest useful thing you can do with a deck someone hands you.

Recipe — import, then fix

moda canvas import-pptx [deck.pptx] — free, async, polls itself to completion (--no-wait returns a job id; re-poll with moda canvas import-pptx --job [JOB_ID]). Send the canvas link the MOMENT it exists.
moda canvas read [CANVAS_REF] --summary — the page index and what landed on each slide.
moda canvas screenshot [CANVAS_REF] --page [IDS] in ≤3-page batches, worst slides first. Judge with your own eyes; list the fixes before making any.
Fix smallest-change-first, one slide at a time: moda canvas edit [CANVAS_REF] --file fix.js for targeted property changes (references/edit-code.md); moda canvas markup [CANVAS_REF] --file - --page [PAGE_ID] --mode replace --revision [REV] to rebuild a slide outright (grammar: references/markup.md); moda canvas delete-items [CANVAS_REF] [NODE_IDS] for cruft. Data preservation is non-negotiable — restate every source string and number verbatim.
Re-theming to the team's kit? moda canvas brand [CANVAS_REF] [KIT] records the kit; the tokens still have to be authored into the slides (kit creation itself is moda-brand's job).
moda canvas screenshot [CANVAS_REF] again and compare against your fix list.
Deliver the live link; export back only on a format word or an accepted offer: moda export [CANVAS_REF] --format pptx -o [deck]-clean.pptx.
Read the export warnings — pptx_shape_rasterized (an image baked in rather than editable) and pptx_content_dropped (an element missing entirely) name exactly what did not survive. Repair or disclose; never hand over a silently degraded deck.

Examples

"clean up this PowerPoint" → import, screenshot the worst slides, fix, export.
"put our brand on this deck" → import, bind the kit, re-author the tokens.
"what's actually in this deck?" → import + read --summary; no edits unasked.
"fix slide 7's chart" → import, then the targeted-edit step on that page only.
"build a NEW deck from this content" → moda-deck owns authoring from scratch.

Errors

Any typed error → load moda-core and read its recovery reference. An import that fails or returns an empty canvas is a file problem, not a retry problem: say what happened, then moda ask "<question>" with the task error.

Make it recurring

The cleaned deck is the team's canonical starting point — flag it with moda canvas template [CANVAS_REF] via moda-templates, so the next deck starts there instead of from another crufty .pptx.

See also: moda-deck — authoring a deck from a brief, doc, or notes · moda-core — the contract, recovery, everything Moda can do.

References

Doc	Load when
references/deck-design.md	judging and rebuilding an imported slide
references/edit-code.md	before any targeted fix program
references/export.md	the pptx round trip and its warnings