| 1 | # Roadmap |
| 2 | |
| 3 | [English](./roadmap.md) | [Chinese](./zh/roadmap.md) |
| 4 | |
| 5 | --- |
| 6 | |
| 7 | > PPT Master is a solo-maintained open source project, driven by **priority rather than fixed timelines**. This roadmap aligns expectations: the direction of travel, what's in motion now, what may come when real demand shows, and what's intentionally out of scope. Priorities shift with user feedback and real usage signals — no committed delivery windows. |
| 8 | |
| 9 | --- |
| 10 | |
| 11 | ## Direction |
| 12 | |
| 13 | The defining axis is **native depth**: author or preserve more of PowerPoint's own object model, behavior, and reusable structure, release after release — converging with PowerPoint itself. The [positioning charter](./project-positioning.md) states the full thesis; the [PowerPoint ↔ SVG Mapping Guide](./powerpoint-svg-mapping.md) records the current boundary honestly, feature by feature. |
| 14 | |
| 15 | Today that axis is expressed through four explicit artifact routes: **Generate PPTX** authors newly designed slides through constrained SVG → DrawingML; **Create Template** produces reusable Brand / Style / Layout / Deck workspaces; **Fill Native PPTX** and **Enhance Native PPTX** preserve existing packages through scoped OOXML operations. |
| 16 | |
| 17 | --- |
| 18 | |
| 19 | ## In progress / Next |
| 20 | |
| 21 | Actively underway or up next — no committed timeline. |
| 22 | |
| 23 | - **Calibrate the recently landed systems on real decks** — multi-deck intake, the material-divergence field, the spot-illustration system, and structured template creation have all shipped; what they need now is real-usage signal, not more mechanism. No pre-emptive thresholds or quotas. |
| 24 | - **Prompt slimming** — compress per-role prompt token footprint and improve cache hit rate without sacrificing quality. This is the indirect cost/speed lever; the boundary with quality-sacrificing speedups is drawn under Non-goals. |
| 25 | |
| 26 | --- |
| 27 | |
| 28 | ## Future directions — signal-driven |
| 29 | |
| 30 | Candidates already evaluated as "worth doing when real demand shows", listed so the intent is public. None is a commitment. |
| 31 | |
| 32 | - **Keep closing the native-coverage gaps** recorded in the [mapping guide](./powerpoint-svg-mapping.md) — release after release, move more "SVG-only" cells toward native PowerPoint structure and behavior. |
| 33 | - **Effects on authored preset shapes** (e.g. a native drop-shadow) — waits for a precise preset-effect contract plus checker coverage; until then, a stock shape that needs a shadow conservatively stays ordinary SVG. |
| 34 | - **Hyperlink authoring in generated decks** — hyperlinks already present in source decks survive conversion today; letting the Strategist author new links waits for demand. |
| 35 | - **Picture slide backgrounds as native background fill** — solid/gradient page backgrounds already export as PowerPoint-native slide backgrounds; the picture case is demand-driven. |
| 36 | |
| 37 | --- |
| 38 | |
| 39 | ## Shipped milestones |
| 40 | |
| 41 | One line per month. Full detail lives in the [release notes](https://github.com/hugohe3/ppt-master/releases) and the commit log. |
| 42 | |
| 43 | | When | Theme | |
| 44 | |---|---| |
| 45 | | 2026-03 | **Native PPTX route takes shape** — the SVG → DrawingML chain becomes usable; chart/layout template indexes ship | |
| 46 | | 2026-04 | **Pipeline at scale** — topic-only generation, 70 chart templates + three icon libraries, the `spec_lock` cross-page consistency contract, per-element animation and narration/video export | |
| 47 | | 2026-05 | **Visual editing + AI-image systematization** — Live Preview with deterministic in-place editing (built on [@WodenJay](https://github.com/WodenJay)'s [PR #85](https://github.com/hugohe3/ppt-master/pull/85)), template workspaces from PPTX, the rendering × palette × type image system, LaTeX formula rendering | |
| 48 | | 2026-06 | **Mode & visual-style dual catalogs + intake expansion** — 5 narrative modes × 18 visual styles (+ `custom`), content-faithful beautify profile, multi-deck intake, spot-illustration pipeline, web-image quality gates, source-conversion fidelity gains (caption recognition from [@suay1113](https://github.com/suay1113)'s [PR #191](https://github.com/hugohe3/ppt-master/pull/191), hyperlink preservation distilled from [@ZhaoZuohong](https://github.com/ZhaoZuohong)'s [PR #155](https://github.com/hugohe3/ppt-master/pull/155)) | |
| 49 | | 2026-07 | **Positioning charter + native masters & layouts + token efficiency** ([v4.0.0](https://github.com/hugohe3/ppt-master/releases/tag/v4.0.0)) — three-pass staged confirmation UI, real `p:sldMaster` / `p:sldLayout` export, `--native-charts-and-tables` opt-in, motion-export hardening, chart template library compacted | |
| 50 | |
| 51 | --- |
| 52 | |
| 53 | ## Non-goals |
| 54 | |
| 55 | The directions below come up repeatedly and have been evaluated as **not on the path**. Listing them is not a value judgment on the underlying need — they simply do not fit this project's product direction. If you specifically need these capabilities, consider other tools or forking. |
| 56 | |
| 57 | ### Blindly refill arbitrary PPTX placeholder systems |
| 58 | |
| 59 | **Issues**: [#53](https://github.com/hugohe3/ppt-master/issues/53), [#118](https://github.com/hugohe3/ppt-master/issues/118) |
| 60 | |
| 61 | The Generate PPTX route is built around full control of newly authored shapes, text, and layout. A structured PPTX can inform a reviewed reusable package in two explicit ways: `standard` / `fidelity` author a new SVG and Master/Layout system from visual evidence, while `mirror` materializes a new workspace from the complete set of supported source facts actually present, including unused Layout definitions. Neither path modifies the source PPTX or recovers absent design intent. Generic "open any PPTX and blindly refill every placeholder" remains a different product shape. |
| 62 | |
| 63 | **The basic need is actually simple**: if you just need "replace Excel data into fixed positions in a PPT template", have the AI write a few lines of `python-pptx`. You don't need this pipeline. |
| 64 | |
| 65 | > **Supported boundaries**: Fill Native PPTX (`template-fill-pptx`) directly refills selected source slides. Create Template (`create-template`) derives an internal authored or mirror implementation from the natural-language request and source evidence. Strategist later derives strict/adaptive exporter behavior from the actual template and current content. What remains out of scope is unreviewed, schema-free substitution against arbitrary third-party placeholder systems. |
| 66 | |
| 67 | ### Make native PowerPoint charts the default |
| 68 | |
| 69 | **Issues**: [#99](https://github.com/hugohe3/ppt-master/issues/99), [#100](https://github.com/hugohe3/ppt-master/issues/100)-class |
| 70 | |
| 71 | Pixel-fidelity across the four renderers (PowerPoint / Keynote / LibreOffice / WPS) is the project's spine. Switching the default route to native PowerPoint charts breaks that — the same PPTX renders different chart layouts across renderers. Charts as SVG is **by design**, not a capability gap. |
| 72 | |
| 73 | The narrow exception is the `data-pptx-replace-with` marker: independently planned supported data charts and pure text-grid tables can carry a PowerPoint-native Chart/Table replacement payload when their Design Spec §IX page block says `Native-ready: yes`; `no` and incidental microvisuals remain ordinary shapes. §VII only records selected reusable references. Exporting with `--native-charts-and-tables` activates prepared markers for users who deliberately trade cross-renderer fidelity for a data-backed object and its chart/table-specific editing model — the activated objects preserve the deck's chart-area / plot / axis / gridline / label colors and native table formatting rather than snapping to PowerPoint's default theme (see the [v4.0.0 release notes](https://github.com/hugohe3/ppt-master/releases/tag/v4.0.0)). The default export path and editable SVG-derived shape system are unchanged. |
| 74 | |
| 75 | ### uv as default / required dependency |
| 76 | |
| 77 | **Issue**: [#111](https://github.com/hugohe3/ppt-master/issues/111) |
| 78 | |
| 79 | `pip + requirements.txt` is the only official install path because it works in every Python environment with no extra learning cost. uv is a fine tool, but making it default raises the bar for new users. If you personally prefer uv, use it in your fork — it won't affect the main line. |
| 80 | |
| 81 | ### Pure speed optimization |
| 82 | |
| 83 | **Issue**: [#97](https://github.com/hugohe3/ppt-master/issues/97) |
| 84 | |
| 85 | In the cost / speed / quality triangle this project picks **quality**. ~20 minutes for a high-quality PPTX is the current reasonable point. |
| 86 | |
| 87 | Will do: indirect improvements via prompt slimming / cache hit rate. |
| 88 | |
| 89 | Explicit `quick-generate` is a user-selected workflow shortcut: it skips |
| 90 | Strategist, confirmation, and the first-page gate, then authors SVG, runs one |
| 91 | lockless final quality gate, and exports the final PPTX. Because the whole |
| 92 | planning phase no longer happens — the Strategist reference load, the |
| 93 | `design_spec.md` / `spec_lock.md` artifacts, and the staged confirmation round |
| 94 | trip — its token cost disappears with it, while per-page SVG authoring is |
| 95 | unchanged. It keeps the same visual/resource capabilities and final blocking |
| 96 | standard, but without a confirmed design contract, first-page calibration, or |
| 97 | resumable decision history it does not promise the same design decisions or |
| 98 | wall-clock time as Default. |
| 99 | |
| 100 | The default Generate pipeline continues to prefer quality over speed. |
| 101 | |
| 102 | ### Standalone CLI / hosted SaaS / desktop app form factors |
| 103 | |
| 104 | The product form is a **chat-driven workflow / skill inside an agent-capable AI tool** (Claude Code, Codex, Cursor, VS Code agents, and others). |
| 105 | |
| 106 | Won't do: standalone CLI (`ppm`-style), SaaS web service, Electron shell. Any "make it run independently of chat" proposal will be declined. Chat is the interaction core, not a wrapper. |
| 107 | |
| 108 | --- |
| 109 | |
| 110 | ## Feedback channels |
| 111 | |
| 112 | - **Issues**: [github.com/hugohe3/ppt-master/issues](https://github.com/hugohe3/ppt-master/issues) — bugs / proposals |
| 113 | - **Discussions**: [github.com/hugohe3/ppt-master/discussions](https://github.com/hugohe3/ppt-master/discussions) — usage / experience sharing |
| 114 | - **Email**: heyug3@gmail.com |
| 115 | |
| 116 | Before proposing a new direction, scan the **Non-goals** above. If your request falls there, it's unlikely to land — but we're happy to discuss other paths to your underlying need. |
| 117 |