Skip to content

nexu-io/open-design / design-templates/html-ppt

html-ppt

Unverified

For consulting delivery work: turn diagnosis, frameworks, and project work into a client-adoptable action plan. Built around the core query "consulting-final-deck", with engagement manager judgment, buyer-ready proof, and this outcome: accept the recommendation and commit owners to the roadmap.

FileKindSize
.clawscan-allowother623 B
LICENSEother1.1 KB
README.mdmarkdown10.5 KB
README.pt-BR.mdmarkdown11.0 KB
README.zh-CN.mdmarkdown11.1 KB
SKILL.mdskill md15.9 KB
assets/animations/animations.cssother7.9 KB
assets/animations/fx-runtime.jsscript3.1 KB
assets/animations/fx/_util.jsscript1.9 KB
assets/animations/fx/chain-react.jsscript1.4 KB
assets/animations/fx/confetti-cannon.jsscript1.5 KB
assets/animations/fx/constellation.jsscript1.3 KB
assets/animations/fx/counter-explosion.jsscript2.3 KB
assets/animations/fx/data-stream.jsscript1.5 KB
assets/animations/fx/firework.jsscript1.6 KB
assets/animations/fx/galaxy-swirl.jsscript1.0 KB
assets/animations/fx/gradient-blob.jsscript1.4 KB
assets/animations/fx/knowledge-graph.jsscript2.4 KB
assets/animations/fx/letter-explode.jsscript2.0 KB
assets/animations/fx/magnetic-field.jsscript1.3 KB
assets/animations/fx/matrix-rain.jsscript1.1 KB
assets/animations/fx/neural-net.jsscript2.6 KB
assets/animations/fx/orbit-ring.jsscript1.3 KB
assets/animations/fx/particle-burst.jsscript1.2 KB
assets/animations/fx/shockwave.jsscript1.3 KB
assets/animations/fx/sparkle-trail.jsscript1.9 KB
assets/animations/fx/starfield.jsscript990 B
assets/animations/fx/typewriter-multi.jsscript2.1 KB
assets/animations/fx/word-cascade.jsscript1.6 KB
assets/base.cssother8.0 KB
assets/fonts.cssother889 B
assets/runtime.jsscript36.2 KB
assets/themes/academic-paper.cssother1.2 KB
assets/themes/arctic-cool.cssother673 B
assets/themes/aurora.cssother1.1 KB
assets/themes/bauhaus.cssother719 B
assets/themes/blueprint.cssother956 B
assets/themes/catppuccin-latte.cssother663 B
assets/themes/catppuccin-mocha.cssother660 B
assets/themes/corporate-clean.cssother949 B
assets/themes/cyberpunk-neon.cssother1.3 KB
assets/themes/dracula.cssother650 B
assets/themes/editorial-serif.cssother863 B
assets/themes/engineering-whiteprint.cssother1.3 KB
assets/themes/glassmorphism.cssother1.1 KB
assets/themes/gruvbox-dark.cssother635 B
assets/themes/japanese-minimal.cssother1004 B
assets/themes/magazine-bold.cssother1.1 KB
assets/themes/memphis-pop.cssother967 B
assets/themes/midcentury.cssother920 B
assets/themes/minimal-white.cssother760 B
assets/themes/neo-brutalism.cssother792 B
assets/themes/news-broadcast.cssother1.1 KB
assets/themes/nord.cssother628 B
assets/themes/pitch-deck-vc.cssother1.2 KB
assets/themes/rainbow-gradient.cssother839 B
assets/themes/retro-tv.cssother1.2 KB
assets/themes/rose-pine.cssother634 B
assets/themes/sharp-mono.cssother739 B
assets/themes/soft-pastel.cssother665 B
assets/themes/solarized-light.cssother645 B
assets/themes/sunset-warm.cssother675 B
assets/themes/swiss-grid.cssother929 B
assets/themes/terminal-green.cssother836 B
assets/themes/tokyo-night.cssother635 B
assets/themes/vaporwave.cssother1.2 KB
assets/themes/xiaohongshu-white.cssother757 B
assets/themes/y2k-chrome.cssother1.3 KB
docs/readme/_theme-cell.htmlother2.6 KB
docs/readme/animations.pngbinary600.1 KB
docs/readme/layouts-live.gifbinary555.8 KB
docs/readme/layouts.pngbinary114.7 KB
docs/readme/montage-animations.htmlother4.6 KB
docs/readme/montage-layouts.htmlother3.1 KB
docs/readme/montage-templates.htmlother3.2 KB
docs/readme/montage-themes.htmlother2.9 KB
docs/readme/presenter-mode.pngbinary503.3 KB
docs/readme/templates.pngbinary289.7 KB
docs/readme/themes.pngbinary245.3 KB
examples/demo-deck/index.htmlother8.7 KB
references/animations.mdmarkdown7.5 KB
references/authoring-guide.mdmarkdown5.3 KB
references/full-decks.mdmarkdown8.4 KB
references/layouts.mdmarkdown3.9 KB
references/presenter-mode.mdmarkdown9.7 KB
references/themes.mdmarkdown5.1 KB
scripts/new-deck.shexecutablescript1.3 KB
scripts/render.shexecutablescript2.8 KB
scripts/verify-output/animation-showcase/animation-showcase_01.pngbinary68.5 KB
scripts/verify-output/animation-showcase/animation-showcase_02.pngbinary59.4 KB
scripts/verify-output/animation-showcase/animation-showcase_03.pngbinary50.5 KB
scripts/verify-output/animation-showcase/animation-showcase_04.pngbinary63.9 KB
scripts/verify-output/animation-showcase/animation-showcase_05.pngbinary315.8 KB
scripts/verify-output/animation-showcase/animation-showcase_06.pngbinary120.2 KB
scripts/verify-output/animation-showcase/animation-showcase_07.pngbinary140.5 KB
scripts/verify-output/animation-showcase/animation-showcase_08.pngbinary207.3 KB
scripts/verify-output/animation-showcase/animation-showcase_09.pngbinary115.3 KB
scripts/verify-output/animation-showcase/animation-showcase_10.pngbinary88.3 KB
scripts/verify-output/animation-showcase/animation-showcase_11.pngbinary62.9 KB
scripts/verify-output/animation-showcase/animation-showcase_12.pngbinary59.8 KB
scripts/verify-output/animation-showcase/animation-showcase_13.pngbinary69.0 KB
scripts/verify-output/animation-showcase/animation-showcase_14.pngbinary80.3 KB
scripts/verify-output/animation-showcase/animation-showcase_15.pngbinary170.1 KB
scripts/verify-output/animation-showcase/animation-showcase_16.pngbinary248.1 KB
scripts/verify-output/animation-showcase/animation-showcase_17.pngbinary64.2 KB
scripts/verify-output/animation-showcase/animation-showcase_18.pngbinary189.7 KB
scripts/verify-output/animation-showcase/animation-showcase_19.pngbinary70.5 KB
scripts/verify-output/animation-showcase/animation-showcase_20.pngbinary89.3 KB
scripts/verify-output/theme-showcase/theme-showcase_01.pngbinary78.6 KB
scripts/verify-output/theme-showcase/theme-showcase_02.pngbinary94.6 KB
scripts/verify-output/theme-showcase/theme-showcase_03.pngbinary91.1 KB
scripts/verify-output/theme-showcase/theme-showcase_04.pngbinary67.5 KB
scripts/verify-output/theme-showcase/theme-showcase_05.pngbinary84.4 KB
scripts/verify-output/theme-showcase/theme-showcase_06.pngbinary87.2 KB
scripts/verify-output/theme-showcase/theme-showcase_07.pngbinary82.3 KB
scripts/verify-output/theme-showcase/theme-showcase_08.pngbinary87.1 KB
scripts/verify-output/theme-showcase/theme-showcase_09.pngbinary75.8 KB
scripts/verify-output/theme-showcase/theme-showcase_10.pngbinary81.2 KB
scripts/verify-output/theme-showcase/theme-showcase_11.pngbinary78.1 KB
scripts/verify-output/theme-showcase/theme-showcase_12.pngbinary80.0 KB
scripts/verify-output/theme-showcase/theme-showcase_13.pngbinary79.2 KB
scripts/verify-output/theme-showcase/theme-showcase_14.pngbinary79.6 KB
scripts/verify-output/theme-showcase/theme-showcase_15.pngbinary68.8 KB
scripts/verify-output/theme-showcase/theme-showcase_16.pngbinary88.2 KB
scripts/verify-output/theme-showcase/theme-showcase_17.pngbinary72.5 KB
scripts/verify-output/theme-showcase/theme-showcase_18.pngbinary69.5 KB
scripts/verify-output/theme-showcase/theme-showcase_19.pngbinary119.3 KB
scripts/verify-output/theme-showcase/theme-showcase_20.pngbinary82.2 KB
scripts/verify-output/theme-showcase/theme-showcase_21.pngbinary81.9 KB
scripts/verify-output/theme-showcase/theme-showcase_22.pngbinary82.5 KB
scripts/verify-output/theme-showcase/theme-showcase_23.pngbinary80.2 KB
scripts/verify-output/theme-showcase/theme-showcase_24.pngbinary69.7 KB
scripts/verify-output/theme-showcase/theme-showcase_25.pngbinary152.3 KB
scripts/verify-output/theme-showcase/theme-showcase_26.pngbinary94.6 KB
scripts/verify-output/theme-showcase/theme-showcase_27.pngbinary90.9 KB
scripts/verify-output/theme-showcase/theme-showcase_28.pngbinary77.4 KB
scripts/verify-output/theme-showcase/theme-showcase_29.pngbinary120.0 KB
scripts/verify-output/theme-showcase/theme-showcase_30.pngbinary80.0 KB
scripts/verify-output/theme-showcase/theme-showcase_31.pngbinary81.7 KB
scripts/verify-output/theme-showcase/theme-showcase_32.pngbinary73.7 KB
scripts/verify-output/theme-showcase/theme-showcase_33.pngbinary77.4 KB
scripts/verify-output/theme-showcase/theme-showcase_34.pngbinary83.2 KB
scripts/verify-output/theme-showcase/theme-showcase_35.pngbinary102.2 KB
scripts/verify-output/theme-showcase/theme-showcase_36.pngbinary78.1 KB
templates/animation-showcase.htmlother7.5 KB
templates/deck.htmlother3.2 KB
templates/full-decks-index.htmlother4.4 KB
templates/full-decks/course-module/README.mdmarkdown627 B
templates/full-decks/course-module/index.htmlother9.8 KB
templates/full-decks/course-module/style.cssother4.3 KB
templates/full-decks/dir-key-nav-minimal/README.mdmarkdown1021 B
templates/full-decks/dir-key-nav-minimal/index.htmlother6.0 KB
templates/full-decks/dir-key-nav-minimal/style.cssother4.7 KB
templates/full-decks/graphify-dark-graph/README.mdmarkdown937 B
templates/full-decks/graphify-dark-graph/index.htmlother10.9 KB
templates/full-decks/graphify-dark-graph/style.cssother5.0 KB
templates/full-decks/hermes-cyber-terminal/README.mdmarkdown1016 B
templates/full-decks/hermes-cyber-terminal/index.htmlother11.5 KB
templates/full-decks/hermes-cyber-terminal/style.cssother5.7 KB
templates/full-decks/knowledge-arch-blueprint/README.mdmarkdown933 B
templates/full-decks/knowledge-arch-blueprint/index.htmlother11.5 KB
templates/full-decks/knowledge-arch-blueprint/style.cssother4.9 KB
templates/full-decks/obsidian-claude-gradient/README.mdmarkdown901 B
templates/full-decks/obsidian-claude-gradient/index.htmlother7.5 KB
templates/full-decks/obsidian-claude-gradient/style.cssother6.0 KB
templates/full-decks/pitch-deck/README.mdmarkdown524 B
templates/full-decks/pitch-deck/index.htmlother7.9 KB
templates/full-decks/pitch-deck/style.cssother3.5 KB
templates/full-decks/presenter-mode-reveal/README.mdmarkdown3.9 KB
templates/full-decks/presenter-mode-reveal/index.htmlother13.8 KB
templates/full-decks/presenter-mode-reveal/style.cssother5.5 KB
templates/full-decks/product-launch/README.mdmarkdown545 B
templates/full-decks/product-launch/index.htmlother6.4 KB
templates/full-decks/product-launch/style.cssother3.9 KB
templates/full-decks/tech-sharing/README.mdmarkdown522 B
templates/full-decks/tech-sharing/index.htmlother8.9 KB
templates/full-decks/tech-sharing/style.cssother3.8 KB
templates/full-decks/testing-safety-alert/README.mdmarkdown967 B
templates/full-decks/testing-safety-alert/index.htmlother11.1 KB
templates/full-decks/testing-safety-alert/style.cssother6.5 KB
templates/full-decks/weekly-report/README.mdmarkdown562 B
templates/full-decks/weekly-report/index.htmlother8.3 KB
templates/full-decks/weekly-report/style.cssother4.9 KB
templates/full-decks/xhs-pastel-card/README.mdmarkdown1.0 KB
templates/full-decks/xhs-pastel-card/index.htmlother9.1 KB
templates/full-decks/xhs-pastel-card/style.cssother5.5 KB
templates/full-decks/xhs-post/README.mdmarkdown628 B
templates/full-decks/xhs-post/index.htmlother7.7 KB
templates/full-decks/xhs-post/style.cssother4.0 KB
templates/full-decks/xhs-white-editorial/README.mdmarkdown995 B
templates/full-decks/xhs-white-editorial/index.htmlother10.6 KB
templates/full-decks/xhs-white-editorial/style.cssother5.6 KB
templates/layout-showcase.htmlother2.2 KB
templates/single-page/arch-diagram.htmlother2.8 KB
templates/single-page/big-quote.htmlother1.0 KB
templates/single-page/bullets.htmlother1.3 KB
templates/single-page/chart-bar.htmlother1.5 KB
templates/single-page/chart-line.htmlother1.9 KB
templates/single-page/chart-pie.htmlother1.9 KB
templates/single-page/chart-radar.htmlother1.8 KB

references/authoring-guide.md

View on GitHub
# Authoring guide

How to turn a user request ("make me a deck about X") into a finished
html-ppt deck. Follow these steps in order.

## 1. Understand the deck

Before touching files, clarify:

1. **Audience** — engineers? designers? executives? consumers?
2. **Length** — 5 min lightning? 20 min share? 45 min talk?
3. **Language** — Chinese, English, bilingual? (Noto Sans SC is preloaded.)
4. **Format** — on-screen live, PDF export, 小红书图文?
5. **Tone** — clinical / playful / editorial / cyber?

The audience + tone map to a theme; the length maps to slide count; the
format maps to runtime features (live → notes + T-cycle; PDF → page-break
CSS, already handled in `base.css`).

## 2. Pick a theme

Use `references/themes.md`. When in doubt:

- **Engineers** → `catppuccin-mocha` / `tokyo-night` / `dracula`.
- **Designers / product** → `editorial-serif` / `aurora` / `soft-pastel`.
- **Execs** → `minimal-white` / `arctic-cool` / `swiss-grid`.
- **Consumers** → `xiaohongshu-white` / `sunset-warm` / `soft-pastel`.
- **Cyber / CLI / infra** → `terminal-green` / `blueprint` / `gruvbox-dark`.
- **Pitch / bold** → `neo-brutalism` / `sharp-mono` / `bauhaus`.
- **Launch / product reveal** → `glassmorphism` / `aurora`.

Wire the theme as `<link id="theme-link" href="../assets/themes/NAME.css">`
and list 3-5 alternatives in `data-themes` so the user can press T to audition.

## 3. Outline the deck

A solid 20-minute deck is usually:

```
cover → toc → section-divider #1 → [2-4 body pages] →
section-divider #2 → [2-4 body pages] → section-divider #3 →
[2-4 body pages] → cta → thanks
```

Pick 1 layout per page from `references/layouts.md`. Don't repeat the same
layout twice in a row.

## 4. Scaffold the deck

```bash
./scripts/new-deck.sh my-talk
```

This copies `templates/deck.html` into `examples/my-talk/index.html` with
paths rewritten. Add/remove `<section class="slide">` blocks to match your
outline.

## 5. Author each slide

For each outline item:

1. Open the matching single-page layout, e.g. `templates/single-page/kpi-grid.html`.
2. Copy the `<section class="slide">…</section>` block.
3. Paste into your deck.
4. Replace demo data with real data. Keep the class structure intact.
5. Set `data-title="..."` (used by the Overview grid).
6. Add `<div class="notes">…</div>` with speaker notes.

## 6. Add animations sparingly

Rules of thumb:

- Cover/title: `rise-in` or `blur-in`.
- Body content: `fade-up` for the hero element, `stagger-list` for grids/lists.
- Stat pages: `counter-up`.
- Section dividers: `perspective-zoom` or `cube-rotate-3d`.
- Closer: `confetti-burst` on the "Thanks" text.

Pick **one** accent animation per slide. Everything else should be calm.

## 7. Chinese + English decks

- Fonts are already imported in `fonts.css` (Noto Sans SC + Noto Serif SC).
- Use `lang="zh-CN"` on `<html>`.
- For bilingual titles, stack lines: `<h1 class="h1">主标题<br><span class="dim">English subtitle</span></h1>`.
- Keep English subtitles in a lighter weight (300) and dim color to avoid
  visual competition.

## 8. Review in-browser

```bash
open examples/my-talk/index.html
```

Walk through every slide with ← →. Press:

- **O** — overview grid; catch any layout clipping.
- **T** — cycle themes; make sure nothing looks broken in any theme.
- **S** — open speaker notes; verify every slide has notes.

## 9. Export to PNG

```bash
# single slide
./scripts/render.sh examples/my-talk/index.html

# all slides (autodetect count by looking for .slide sections)
./scripts/render.sh examples/my-talk/index.html all

# explicit slide count + output dir
./scripts/render.sh examples/my-talk/index.html 12 out/my-talk-png
```

Output is 1920×1080 by default. Change in `render.sh` if the user wants 3:4
for 小红书图文 (1242×1660).

The renderer uses Playwright's managed Chromium. Do not replace it with
`/Applications/Google Chrome.app` or another user-profile Chrome launch on
macOS. If the managed renderer fails once, report the error and stop instead of
retrying alternate Chrome commands.

## 10. What to NOT do

- Don't hand-author from a blank file.
- Don't use raw hex colors in slide markup. Use tokens.
- Don't load heavy animation frameworks. Everything should stay within the
  CSS/JS that already ships.
- Don't add more than one new template file unless a genuinely new layout
  type is needed. Prefer composition.
- Don't delete slides from the showcase decks.
- **Don't put presenter-only text on the slide.** Any descriptive text,
  narration cues, or explanations meant for the speaker (e.g. "这一页的重点是…",
  "Note: mention X here", small grey captions explaining the slide's purpose)
  MUST go inside `<div class="notes">`, not as visible elements. The `.notes`
  div is hidden (`display:none`) and only shown via the S overlay. Slides
  should contain ONLY audience-facing content.

## Troubleshooting

- **Theme doesn't switch with T**: check `data-themes` on `<body>` and
  `data-theme-base` pointing to the themes directory relative to the HTML
  file.
- **Fonts fall back**: make sure `fonts.css` is linked before the theme.
- **Chart.js colors wrong**: charts read CSS vars in JS; make sure they run
  after the DOM is ready (`addEventListener('DOMContentLoaded', …)`).
- **PNG too small**: bump `--viewport-size` in `scripts/render.sh`.
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall