Skip to content

Commit 687a878

Browse files
committed
examples: add 7 new projects, extract shared examples.json, update stats to 22/309
- Add 7 example projects: building_effective_agents, home_design_trends, kimsoong_loyalty, liziqi_plant_dye, lin_huiyin_architect (×2), fashion_weekly - Extract inline project data from index.html and viewer.html into shared examples/examples.json - Standardize folder naming: ppt169_ prefix, English, no date suffix - Clean up exports (remove SVG pptx, timestamps), cropped images, source image dirs, empty templates - Update stats across README, README_CN, docs: 15→22 projects, 229→309 pages
1 parent 358fd8c commit 687a878

421 files changed

Lines changed: 24772 additions & 588 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ PPT Master is different:
5050
- **Data stays local** — your files shouldn't have to be uploaded to someone else's server just to make a presentation. Apart from AI model communication, the entire pipeline runs on your machine
5151
- **No platform lock-in** — your workflow shouldn't be held hostage by any single company. Works with Claude Code, Cursor, VS Code Copilot, and more; supports Claude, GPT, Gemini, Kimi, and other models
5252

53-
**[See live examples →](https://hugohe3.github.io/ppt-master/)** · [`examples/`](./examples/)15 projects, 229 pages
53+
**[See live examples →](https://hugohe3.github.io/ppt-master/)** · [`examples/`](./examples/)22 projects, 309 pages
5454

5555
## Gallery
5656

@@ -254,7 +254,7 @@ Multiple backends are supported across Core / Extended / Experimental tiers. Run
254254
| 🎨 | [Create a Custom Template](./skills/ppt-master/workflows/create-template.md) | Standalone workflow for building your own brand or industry template |
255255
| 📐 | [Canvas Formats](./skills/ppt-master/references/canvas-formats.md) | PPT 16:9, Xiaohongshu, WeChat, and 10+ formats |
256256
| 🛠️ | [Scripts & Tools](./skills/ppt-master/scripts/README.md) | All scripts and commands |
257-
| 💼 | [Examples](./examples/README.md) | 15 projects, 229 pages |
257+
| 💼 | [Examples](./examples/README.md) | 22 projects, 309 pages |
258258
| 🏗️ | [Technical Design](./docs/technical-design.md) | Architecture, design philosophy, why SVG |
259259
|| [FAQ](./docs/faq.md) | Model selection, cost, layout troubleshooting, custom templates |
260260

README_CN.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ PPT Master 不一样:
5050
- **数据不出本地** — 你的文件不应该为了做一份 PPT 就被上传到别人的服务器。除与 AI 模型的对话外,全流程在你的电脑上完成
5151
- **不锁定平台** — 你的工作流不应该被任何一家公司绑架。Claude Code、Cursor、VS Code Copilot 等均可驱动;Claude、GPT、Gemini、Kimi 等模型均可使用
5252

53-
**[在线预览 →](https://hugohe3.github.io/ppt-master/)** · [`examples/`](./examples/)15 个项目,229
53+
**[在线预览 →](https://hugohe3.github.io/ppt-master/)** · [`examples/`](./examples/)22 个项目,309
5454

5555
## 效果展示
5656

@@ -258,7 +258,7 @@ GEMINI_MODEL=gemini-3.1-flash-image-preview
258258
| 🎨 | [创建自定义模板](./skills/ppt-master/workflows/create-template.md) | 独立工作流,构建你自己的品牌或行业模板 |
259259
| 📐 | [画布格式](./skills/ppt-master/references/canvas-formats.md) | PPT 16:9、小红书、朋友圈等 10+ 种格式 |
260260
| 🛠️ | [脚本与工具](./skills/ppt-master/scripts/README.md) | 所有脚本和命令 |
261-
| 💼 | [示例](./examples/README.md) | 15 个项目,229|
261+
| 💼 | [示例](./examples/README.md) | 22 个项目,309|
262262
| 🏗️ | [技术路线](./docs/zh/technical-design.md) | 架构、设计哲学、为什么选 SVG |
263263
|| [常见问题](./docs/zh/faq.md) | 模型选择、费用、排版问题排查、自定义模板 |
264264

docs/why-ppt-master.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,7 @@ The choice is yours. PPT Master doesn't make that decision for you.
6565

6666
Three built-in styles: General (training, tech talks), Consultant (business reports, data visualization), and Consultant Top (MBB level — investment memos, strategic plans, government briefings).
6767

68-
The [examples/](../examples/) directory contains 15 projects and 229 pages spanning government fiscal analysis, AI architecture design, Zen philosophy, pixel-art gaming, and more.
68+
The [examples/](../examples/) directory contains 22 projects and 309 pages spanning government fiscal analysis, AI architecture design, Zen philosophy, pixel-art gaming, editorial reports, and more.
6969

7070
### Full Source-Document Input
7171

docs/zh/why-ppt-master.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,7 @@ PPT Master 是一个框架,不是某个 IDE 的插件。**编辑器方面**,
6565

6666
内建三套风格:通用灵活(培训分享、技术演示)、咨询风(商业报告、数据可视化)、顶级咨询风(MBB 级,投资尽调、战略规划、政府汇报)。
6767

68-
[examples/](../../examples/) 目录包含 15 个项目、229 页,涵盖政府财政分析、AI 架构设计、禅学研究、像素游戏风等不同设计风格
68+
[examples/](../../examples/) 目录包含 22 个项目、309 页,涵盖政府财政分析、AI 架构设计、禅学研究、像素游戏风、杂志编辑风等不同设计风格
6969

7070
### 全格式源文档输入
7171

examples/README.md

Lines changed: 132 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,17 @@
11
# PPT Master Example Projects
22

3-
> This directory contains **15 curated example projects** covering consulting style, general-purpose style, creative style, and other design paradigms, totaling **229 SVG presentation pages**.
3+
> This directory contains **22 curated example projects** covering consulting style, general-purpose style, creative style, magazine editorial style, and cultural narrative paradigms, totaling **309 SVG presentation pages**.
44
55
**[Preview all example projects online](https://hugohe3.github.io/ppt-master/)**
66

77
## Overview
88

99
| Category | Projects | Total Pages | Highlights |
1010
|----------|----------|-------------|------------|
11-
| Consulting Style | 8 | 142 pages | Data-driven, structured, professional whitespace |
12-
| General-Purpose | 3 | 32 pages | Flexible layouts, diverse themes |
11+
| Consulting Style | 9 | 152 pages | Data-driven, structured, professional whitespace |
12+
| General-Purpose | 5 | 55 pages | Flexible layouts, diverse themes, dark tech |
1313
| Creative Style | 4 | 55 pages | Unique visual language, cultural aesthetics |
14+
| Magazine & Cultural Narrative | 4 | 47 pages | Photo-rich editorial, Eastern aesthetics |
1415

1516
---
1617

@@ -135,6 +136,23 @@
135136

136137
---
137138

139+
### ppt169_kimsoong_loyalty_programme
140+
141+
> **10 pages** - MBB-level strategic proposal (English)
142+
143+
| Property | Details |
144+
|----------|---------|
145+
| **Canvas Format** | PPT 16:9 (1280×720) |
146+
| **Design Style** | Top Consulting (MBB-level) |
147+
| **Color Scheme** | Navy #1A3A5C + Amber #E8A838 + Eco green #2D8A4E |
148+
| **Target Audience** | Senior management / board at Kimsoong European HQ |
149+
150+
**Key Features**: Strategic customer loyalty programme proposal for an automotive brand's European operations. Covers customer demographics (75% under 40), root cause analysis (78% addressable churn), four-pillar strategy framework, five ranked initiatives, and a phased Q1-Q4 implementation roadmap with KPI targets. Features KPI dashboards, Pareto charts, 2×2 priority matrices, and hub-spoke diagrams.
151+
152+
[View Project](./ppt169_kimsoong_loyalty_programme/) | [Design Spec](./ppt169_kimsoong_loyalty_programme/design_spec.md)
153+
154+
---
155+
138156
### ppt169_谷歌风_google_annual_report
139157

140158
> **10 pages** - Google brand style
@@ -152,6 +170,23 @@
152170

153171
---
154172

173+
### ppt169_building_effective_agents
174+
175+
> **12 pages** - Technical engineering talk (English)
176+
177+
| Property | Details |
178+
|----------|---------|
179+
| **Canvas Format** | PPT 16:9 (1280×720) |
180+
| **Design Style** | General Versatile — Dark theme |
181+
| **Color Scheme** | Anthropic coral #D4845A + Cool blue #5B9BD5 on deep dark #0F1117 |
182+
| **Target Audience** | Software engineers, AI/ML practitioners, technical leaders |
183+
184+
**Key Features**: Based on Anthropic's "Building Effective Agents" engineering blog. Covers the augmented LLM building block, five workflow patterns (Prompt Chaining, Routing, Parallelization, Orchestrator-Workers, Evaluator-Optimizer), autonomous agent architecture, and practical application (coding agents, customer support). Includes 8 original article architecture diagrams with warm-on-dark aesthetic.
185+
186+
[View Project](./ppt169_building_effective_agents/) | [Design Spec](./ppt169_building_effective_agents/design_spec.md)
187+
188+
---
189+
155190
## General-Purpose Style Examples
156191

157192
### ppt169_通用灵活+代码_debug六步法
@@ -205,6 +240,23 @@
205240

206241
---
207242

243+
### ppt169_home_design_trends_2026
244+
245+
> **12 pages** - Magazine-style home design trends
246+
247+
| Property | Details |
248+
|----------|---------|
249+
| **Canvas Format** | PPT 16:9 (1280×720) |
250+
| **Design Style** | General Versatile — Magazine editorial |
251+
| **Color Scheme** | Warm brown #C4A882 + Terracotta #D4956A on deep warm black #1A1714 |
252+
| **Target Audience** | Interior designers, home enthusiasts, renovation planners |
253+
254+
**Key Features**: 2026 home design trends presentation inspired by the book "空间的高级感". Covers color theory, material language, texture details, the CMT (Colour-Material-Texture) system, cream style evolution, bohemian & vintage revival, and sustainable luxury. Rich photography with editorial typography using Georgia serif titles. 22+ curated interior photography images.
255+
256+
[View Project](./ppt169_home_design_trends_2026/) | [Design Spec](./ppt169_home_design_trends_2026/design_spec.md)
257+
258+
---
259+
208260
## Creative Style Examples
209261

210262
### ppt169_易理风_地山谦卦深度研究
@@ -275,14 +327,87 @@
275327

276328
---
277329

330+
## Magazine & Cultural Narrative Examples
331+
332+
### ppt169_liziqi_plant_dye_colors
333+
334+
> **12 pages** - Eastern cultural narrative on plant dyeing
335+
336+
| Property | Details |
337+
|----------|---------|
338+
| **Canvas Format** | PPT 16:9 (1280×720) |
339+
| **Design Style** | General Versatile — Eastern cultural narrative |
340+
| **Color Scheme** | Rice paper white #F7F2E8 + Rain-washed sky blue #6B9AAE + Oriole yellow #C99E62 + Orchid grass green #6F8F75 |
341+
| **Target Audience** | Cultural enthusiasts, designers, museum/education professionals |
342+
343+
**Key Features**: Explores the 300 traditional Chinese colors behind Li Ziqi's 2025 Spring Festival Gala costume. Covers the five cardinal colors, hand-dip dyeing technique, historical timeline from Emperor Huang Di to Ming-Qing dynasties, six named traditional colors with poetic origins (雨过天青, 苍黄, 暮云灰, 天水碧, 银红, 酡色), dyeing plant taxonomy, and the therapeutic art of plant dyeing. Uses KaiTi calligraphic titles on rice-paper-textured backgrounds. 17 curated photographs.
344+
345+
[View Project](./ppt169_liziqi_plant_dye_colors/) | [Design Spec](./ppt169_liziqi_plant_dye_colors/design_spec.md)
346+
347+
---
348+
349+
### ppt169_lin_huiyin_architect
350+
351+
> **10 pages** - Dark theme architectural tribute
352+
353+
| Property | Details |
354+
|----------|---------|
355+
| **Canvas Format** | PPT 16:9 (1280×720) |
356+
| **Design Style** | General Versatile — Chinese classical architecture × humanistic memorial |
357+
| **Color Scheme** | Deep navy #1A1A2E + Antique gold #C9A96E + Ivory #E8D5B7 |
358+
| **Target Audience** | Cultural enthusiasts, architecture followers, humanities readers |
359+
360+
**Key Features**: A tribute to Lin Huiyin as a pioneering architect — reframing her beyond the literary celebrity persona. Covers her architectural works (Jihai Railway Station, PKU Geology Building, People's Heroes Monument), groundbreaking 1932 academic paper on Chinese architecture, original concepts (建筑意), and her enduring spirit through wartime adversity. Dark theme with antique gold accents and KaiTi calligraphic titles. 13 historical photographs.
361+
362+
[View Project](./ppt169_lin_huiyin_architect/) | [Design Spec](./ppt169_lin_huiyin_architect/design_spec.md)
363+
364+
---
365+
366+
### ppt169_lin_huiyin_architect_revised
367+
368+
> **9 pages** - Light theme museum-exhibition edition (revised)
369+
370+
| Property | Details |
371+
|----------|---------|
372+
| **Canvas Format** | PPT 16:9 (1280×720) |
373+
| **Design Style** | General Versatile — Museum exhibition, architectural atlas |
374+
| **Color Scheme** | Paper white #F6F1E8 + Brick red #A44A3F + Slate gray #6E7C80 + Bronze #B6915E |
375+
| **Target Audience** | Architecture & humanities audiences, cultural communicators |
376+
377+
**Key Features**: Revised edition of the Lin Huiyin tribute, reimagined with a light-theme museum-exhibition aesthetic. Adopts restrained editorial typography (Georgia + Songti SC) on warm paper backgrounds. Covers the same architectural legacy through a "rediscovery" lens — from built works and national monuments to theoretical foundations and field methodology. Uses tabler-outline icons for a refined, contemporary feel. 13 historical photographs.
378+
379+
[View Project](./ppt169_lin_huiyin_architect_revised/) | [Design Spec](./ppt169_lin_huiyin_architect_revised/design_spec.md)
380+
381+
---
382+
383+
### ppt169_fashion_weekly_digest
384+
385+
> **16 pages** - Luxury fashion magazine editorial
386+
387+
| Property | Details |
388+
|----------|---------|
389+
| **Canvas Format** | PPT 16:9 (1280×720) |
390+
| **Design Style** | General Versatile — Magazine Editorial |
391+
| **Color Scheme** | Deep black #0A0A0A + Gold #C9A96E + Light gold #E8D5B5 |
392+
| **Target Audience** | Fashion industry professionals, luxury enthusiasts, brand marketers |
393+
394+
**Key Features**: Weekly fashion news digest covering 18+ luxury and lifestyle brands (Hermès, CHANEL, Dior, Louis Vuitton, Gucci, CELINE, BV, McQueen, Max Mara, Chloé, and more). Magazine editorial layouts with full-bleed photography, asymmetric splits, figure-text overlaps, and two-column brand comparisons. Uses phosphor-duotone icons for a modern dual-tone aesthetic. 21 brand photography images across topics including Milan Design Week, Coachella, flagship exhibitions, and brand collaborations.
395+
396+
[View Project](./ppt169_fashion_weekly_digest/) | [Design Spec](./ppt169_fashion_weekly_digest/design_spec.md)
397+
398+
---
399+
278400
## Project Structure
279401

280402
Each example project follows this standard structure:
281403

282404
```
283405
<project_name>/
284406
├── design_spec.md # Design specification document (required)
407+
├── spec_lock.md # Machine-readable execution contract (newer projects)
285408
├── images/ # Image assets (if any)
409+
├── sources/ # Source materials (if any)
410+
├── notes/ # Speaker notes (if any)
286411
├── svg_output/ # Original SVGs (with placeholders, as templates)
287412
│ ├── slide_01_xxx.svg
288413
│ └── ...
@@ -327,6 +452,9 @@ xdg-open examples/<project_name>/svg_final/slide_01_cover.svg
327452
3. **Complex Projects**: Explore `ppt169_顶级咨询风_心理治疗中的依恋` (32 pages) to understand large-scale project organization
328453
4. **Government Style**: Refer to `ppt169_顶级咨询风_甘孜州经济财政分析` (17 pages) to master data-driven analysis
329454
5. **Creative Exploration**: Study the I Ching or Zen style for unique visual languages
455+
6. **Cultural Narrative**: Explore `ppt169_liziqi_plant_dye_colors` for Eastern aesthetics with rich photography
456+
7. **Magazine Editorial**: Study `ppt169_fashion_weekly_digest` for luxury brand editorial layouts
457+
8. **Same Topic, Two Styles**: Compare `ppt169_lin_huiyin_architect` (dark) vs `ppt169_lin_huiyin_architect_revised` (light) to understand how theme choice transforms the same content
330458

331459
## Contributing Examples
332460

@@ -352,4 +480,4 @@ We welcome your project contributions! Please ensure:
352480

353481
---
354482

355-
*Last updated: 2025-12-13*
483+
*Last updated: 2026-04-26*

0 commit comments

Comments
 (0)