diff --git a/README.md b/README.md
index 4c3abdb..9ea976b 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,8 @@
 **Author:** lewis &lt;sudolewis@gmail.com&gt;
 **License:** MIT
 
+![html-ppt · 36 themes](docs/readme/themes.png)
+
 ## Install (one command)
 
 ```bash
@@ -48,6 +50,8 @@ Each is a pure CSS-tokens file — swap one `<link>` to reskin the entire deck.
 Browse them all in `templates/theme-showcase.html` (each slide rendered in an
 isolated iframe so theme ≠ theme is visually guaranteed).
 
+![14 full-deck templates](docs/readme/templates.png)
+
 ### 14 Full-deck templates
 
 Eight extracted from real-world decks, six generic scenario scaffolds:
@@ -70,6 +74,8 @@ Each is a self-contained folder with scoped `.tpl-<name>` CSS so multiple
 decks can be previewed side-by-side without collisions. Browse the full
 gallery in `templates/full-decks-index.html`.
 
+![31 single-page layouts](docs/readme/layouts.png)
+
 ### 31 Single-page layouts
 
 cover · toc · section-divider · bullets · two-column · three-column ·
@@ -81,6 +87,8 @@ chart-pie · chart-radar · arch-diagram · process-steps · cta · thanks
 Every layout ships with realistic demo data so you can drop it into a deck
 and immediately see it render.
 
+![47 animations — 27 CSS + 20 canvas FX](docs/readme/animations.png)
+
 ### 27 CSS animations + 20 Canvas FX
 
 **CSS (lightweight)** — directional fades, `rise-in`, `zoom-pop`, `blur-in`,
diff --git a/docs/readme/_theme-cell.html b/docs/readme/_theme-cell.html
new file mode 100644
index 0000000..ae224c3
--- /dev/null
+++ b/docs/readme/_theme-cell.html
@@ -0,0 +1,56 @@
+<!doctype html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8">
+<title>theme cell</title>
+<link rel="stylesheet" href="../../assets/fonts.css">
+<link rel="stylesheet" href="../../assets/base.css">
+<link id="theme-link" rel="stylesheet" href="../../assets/themes/minimal-white.css">
+<style>
+  html,body{height:100%;margin:0;overflow:hidden}
+  body{
+    background:var(--bg,#fff);color:var(--text-1,#111);
+    font-family:var(--font-sans);box-sizing:border-box;
+    padding:5cqw 6cqw;container-type:size;
+  }
+  .k{font:700 2.6cqw/1 var(--font-mono,monospace);color:var(--text-3,#888);letter-spacing:.14em;text-transform:uppercase;margin-bottom:2.5cqh}
+  h1{font:900 11cqw/.95 var(--font-display,var(--font-sans));letter-spacing:-.025em;margin:0 0 3cqh;color:var(--text-1)}
+  .lede{font:500 3.2cqw/1.4 var(--font-sans);color:var(--text-2,#555);margin:0 0 3.5cqh;max-width:85cqw}
+  .row{display:flex;gap:1.4cqw;flex-wrap:wrap}
+  .pill{padding:1.2cqh 2.4cqw;border-radius:999px;background:var(--surface-2,#f4f4f8);color:var(--text-1);font:600 2.3cqw/1 var(--font-sans);border:1px solid var(--border,#e5e5ea)}
+  .pill.accent{background:var(--accent,#7c5cff);color:#fff;border-color:transparent}
+  .kpi{margin-top:4cqh;display:flex;gap:5cqw}
+  .kpi div{font:900 10cqw/1 var(--font-display,var(--font-sans));letter-spacing:-.03em;color:var(--accent,#7c5cff)}
+  .kpi div span{display:block;font:500 1.8cqw/1 var(--font-sans);color:var(--text-3,#888);margin-top:1cqh;letter-spacing:.08em;text-transform:uppercase}
+  .gradient-hero{background:linear-gradient(90deg,var(--accent,#7c5cff),var(--accent-2,#22d3ee),var(--accent-3,#ff4d8d));-webkit-background-clip:text;background-clip:text;-webkit-text-fill-color:transparent}
+</style>
+</head>
+<body>
+  <div class="k" id="kname">theme · minimal-white</div>
+  <h1 id="h1">2026<br>年度回顾</h1>
+  <p class="lede">同一份 outline，换一行 theme，排版、字体、色系、装饰全部重写。</p>
+  <div class="row">
+    <span class="pill accent">12 里程碑</span>
+    <span class="pill">团队 +40%</span>
+    <span class="pill">SAT 98%</span>
+  </div>
+  <div class="kpi">
+    <div>98%<span>Sat</span></div>
+    <div>12<span>MS</span></div>
+    <div>7×<span>Faster</span></div>
+  </div>
+<script>
+(function(){
+  const m = /[?&]theme=([\w-]+)/.exec(location.search||'');
+  if (m){
+    const name = m[1];
+    document.getElementById('theme-link').href = '../../assets/themes/'+name+'.css';
+    document.getElementById('kname').textContent = 'theme · ' + name;
+    if (/rainbow|aurora|cyberpunk|vaporwave|y2k/.test(name)){
+      document.getElementById('h1').classList.add('gradient-hero');
+    }
+  }
+})();
+</script>
+</body>
+</html>
diff --git a/docs/readme/animations.png b/docs/readme/animations.png
new file mode 100644
index 0000000..fe1cd5e
Binary files /dev/null and b/docs/readme/animations.png differ
diff --git a/docs/readme/layouts.png b/docs/readme/layouts.png
new file mode 100644
index 0000000..43b3321
Binary files /dev/null and b/docs/readme/layouts.png differ
diff --git a/docs/readme/montage-animations.html b/docs/readme/montage-animations.html
new file mode 100644
index 0000000..53db82b
--- /dev/null
+++ b/docs/readme/montage-animations.html
@@ -0,0 +1,61 @@
+<!doctype html>
+<html lang="en" data-theme="aurora">
+<head>
+<meta charset="utf-8">
+<title>47 animations showcase</title>
+<link rel="stylesheet" href="../../assets/fonts.css">
+<link rel="stylesheet" href="../../assets/base.css">
+<link rel="stylesheet" href="../../assets/themes/aurora.css">
+<link rel="stylesheet" href="../../assets/animations/animations.css">
+<style>
+  *{box-sizing:border-box;margin:0;padding:0}
+  html,body{width:1920px;height:1080px;overflow:hidden}
+  body{background:#0a0a14;font-family:"PingFang SC","Noto Sans SC","Inter",-apple-system,sans-serif;color:#fff;padding:48px 56px 44px;display:flex;flex-direction:column;gap:28px}
+  .hdr{display:flex;align-items:flex-end;justify-content:space-between}
+  .hdr h2{font:900 48px/1 "Inter",sans-serif;letter-spacing:-.02em;color:#fff}
+  .hdr h2 b{display:inline-block;font-size:58px;padding-right:14px;background:linear-gradient(90deg,#ff4d8d,#f59e0b,#22d3ee);-webkit-background-clip:text;background-clip:text;-webkit-text-fill-color:transparent}
+  .hdr .sub{font:600 16px/1 "JetBrains Mono","SF Mono",monospace;color:#aab0c0;letter-spacing:.1em;text-transform:uppercase}
+  .grid{flex:1;display:grid;grid-template-columns:repeat(4,1fr);grid-template-rows:repeat(2,1fr);gap:18px;min-height:0}
+  .cell{position:relative;border-radius:18px;overflow:hidden;border:1px solid rgba(255,255,255,.08);box-shadow:0 20px 56px rgba(0,0,0,.45);background:#050510;min-height:0}
+  .cell .fx-host{position:absolute;inset:0}
+  .cell .label{position:absolute;left:14px;bottom:12px;z-index:5;font:700 11px/1 "JetBrains Mono","SF Mono",monospace;letter-spacing:.1em;padding:6px 12px;border-radius:999px;background:rgba(10,10,20,.72);color:#fff;text-transform:uppercase;border:1px solid rgba(255,255,255,.14);backdrop-filter:blur(6px)}
+  .cell .kind{position:absolute;left:14px;top:12px;z-index:5;font:700 10px/1 "JetBrains Mono","SF Mono",monospace;letter-spacing:.14em;padding:5px 10px;border-radius:999px;background:rgba(255,255,255,.1);color:#fff;text-transform:uppercase;border:1px solid rgba(255,255,255,.16)}
+</style>
+</head>
+<body>
+  <div class="hdr">
+    <h2><b>47</b>Animations — 27 CSS · 20 Canvas FX</h2>
+    <div class="sub">html-ppt · data-anim="…" / data-fx="…" · pick 8 canvas FX</div>
+  </div>
+  <div class="grid">
+    <div class="cell"><span class="kind">data-fx</span><div class="fx-host" data-fx="knowledge-graph" style="--accent:#7c5cff;--accent-2:#22d3ee;--text-1:#fff"></div><span class="label">knowledge-graph</span></div>
+    <div class="cell"><span class="kind">data-fx</span><div class="fx-host" data-fx="neural-net" style="--accent:#22d3ee;--accent-2:#ff4d8d"></div><span class="label">neural-net</span></div>
+    <div class="cell"><span class="kind">data-fx</span><div class="fx-host" data-fx="galaxy-swirl" style="--accent:#7c5cff;--accent-2:#ff4d8d"></div><span class="label">galaxy-swirl</span></div>
+    <div class="cell"><span class="kind">data-fx</span><div class="fx-host" data-fx="constellation" style="--accent:#9fb4ff"></div><span class="label">constellation</span></div>
+    <div class="cell"><span class="kind">data-fx</span><div class="fx-host" data-fx="matrix-rain"></div><span class="label">matrix-rain</span></div>
+    <div class="cell"><span class="kind">data-fx</span><div class="fx-host" data-fx="starfield" style="--accent:#fff;--accent-2:#9fb4ff"></div><span class="label">starfield</span></div>
+    <div class="cell"><span class="kind">data-fx</span><div class="fx-host" data-fx="firework" style="--accent:#ff4d8d;--accent-2:#22d3ee"></div><span class="label">firework</span></div>
+    <div class="cell"><span class="kind">data-fx</span><div class="fx-host" data-fx="particle-burst" style="--accent:#ff4d8d;--accent-2:#7c5cff"></div><span class="label">particle-burst</span></div>
+  </div>
+<script src="../../assets/animations/fx/_util.js"></script>
+<script src="../../assets/animations/fx/knowledge-graph.js"></script>
+<script src="../../assets/animations/fx/neural-net.js"></script>
+<script src="../../assets/animations/fx/galaxy-swirl.js"></script>
+<script src="../../assets/animations/fx/constellation.js"></script>
+<script src="../../assets/animations/fx/matrix-rain.js"></script>
+<script src="../../assets/animations/fx/starfield.js"></script>
+<script src="../../assets/animations/fx/firework.js"></script>
+<script src="../../assets/animations/fx/particle-burst.js"></script>
+<script>
+(function(){
+  document.querySelectorAll('[data-fx]').forEach(el => {
+    const name = el.getAttribute('data-fx');
+    const fn = window.HPX && window.HPX[name];
+    if (typeof fn === 'function') {
+      try { fn(el, {}); } catch(e) { console.warn('[fx]', name, e); }
+    }
+  });
+})();
+</script>
+</body>
+</html>
diff --git a/docs/readme/montage-layouts.html b/docs/readme/montage-layouts.html
new file mode 100644
index 0000000..9f4a536
--- /dev/null
+++ b/docs/readme/montage-layouts.html
@@ -0,0 +1,72 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<title>31 layouts showcase</title>
+<style>
+  :root{--ink:#0b0b10;--muted:#6b6b78;--line:#e7e7ef}
+  *{box-sizing:border-box;margin:0;padding:0}
+  html,body{width:1920px;height:1080px;overflow:hidden}
+  body{background:#f6f7fa;font-family:"PingFang SC","Noto Sans SC","Inter",-apple-system,sans-serif;color:var(--ink);padding:48px 56px 44px;display:flex;flex-direction:column;gap:28px}
+  .hdr{display:flex;align-items:flex-end;justify-content:space-between}
+  .hdr h2{font:900 48px/1 "Inter",sans-serif;letter-spacing:-.02em}
+  .hdr h2 b{display:inline-block;font-size:58px;padding-right:14px;background:linear-gradient(90deg,#2563eb,#22d3ee);-webkit-background-clip:text;background-clip:text;-webkit-text-fill-color:transparent}
+  .hdr .sub{font:600 16px/1 "JetBrains Mono","SF Mono",monospace;color:var(--muted);letter-spacing:.1em;text-transform:uppercase}
+  .grid{flex:1;display:grid;grid-template-columns:repeat(4,1fr);grid-template-rows:repeat(2,1fr);gap:18px;min-height:0}
+  .cell{position:relative;border-radius:18px;overflow:hidden;border:1px solid var(--line);box-shadow:0 16px 48px rgba(10,10,30,.1);background:#fff;min-height:0}
+  .cell iframe{position:absolute;inset:0;width:1920px;height:1080px;border:0;pointer-events:none;transform-origin:top left}
+  .cell .label{position:absolute;left:14px;bottom:12px;z-index:5;font:700 11px/1 "JetBrains Mono","SF Mono",monospace;letter-spacing:.1em;padding:6px 12px;border-radius:999px;background:rgba(255,255,255,.94);color:#1a1a22;text-transform:uppercase;border:1px solid rgba(0,0,0,.06)}
+</style>
+</head>
+<body>
+  <div class="hdr">
+    <h2><b>31</b>Layouts — batteries included, demo data bundled</h2>
+    <div class="sub">html-ppt · templates/single-page/*.html · pick 8 of 31</div>
+  </div>
+  <div class="grid" id="grid"></div>
+
+<script>
+const LAYOUTS = [
+  ['kpi-grid','KPI Grid'],
+  ['chart-bar','Chart · Bar'],
+  ['timeline','Timeline'],
+  ['mindmap','Mindmap'],
+  ['flow-diagram','Flow Diagram'],
+  ['roadmap','Roadmap'],
+  ['pros-cons','Pros / Cons'],
+  ['code','Code']
+];
+const grid = document.getElementById('grid');
+LAYOUTS.forEach(([name,label]) => {
+  const cell = document.createElement('div');
+  cell.className = 'cell';
+  const ifr = document.createElement('iframe');
+  ifr.src = '../../templates/single-page/' + name + '.html';
+  ifr.loading = 'eager';
+  cell.appendChild(ifr);
+  const lab = document.createElement('span');
+  lab.className = 'label';
+  lab.textContent = label + ' · ' + name;
+  cell.appendChild(lab);
+  grid.appendChild(cell);
+});
+
+function fit(){
+  document.querySelectorAll('.cell iframe').forEach(ifr => {
+    const c = ifr.parentElement;
+    const w = c.clientWidth, h = c.clientHeight;
+    const s = Math.min(w / 1920, h / 1080);
+    ifr.style.transform = 'scale('+s+')';
+    const sw = 1920*s, sh = 1080*s;
+    ifr.style.left = ((w - sw)/2) + 'px';
+    ifr.style.top  = ((h - sh)/2) + 'px';
+    ifr.style.position = 'absolute';
+  });
+}
+window.addEventListener('resize', fit);
+setTimeout(fit, 80);
+setTimeout(fit, 400);
+setTimeout(fit, 1200);
+</script>
+</body>
+</html>
diff --git a/docs/readme/montage-templates.html b/docs/readme/montage-templates.html
new file mode 100644
index 0000000..99803bd
--- /dev/null
+++ b/docs/readme/montage-templates.html
@@ -0,0 +1,72 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<title>14 full-deck templates showcase</title>
+<style>
+  :root{--ink:#0b0b10;--muted:#6b6b78;--line:#e7e7ef}
+  *{box-sizing:border-box;margin:0;padding:0}
+  html,body{width:1920px;height:1080px;overflow:hidden}
+  body{background:#f6f7fa;font-family:"PingFang SC","Noto Sans SC","Inter",-apple-system,sans-serif;color:var(--ink);padding:48px 56px 44px;display:flex;flex-direction:column;gap:28px}
+  .hdr{display:flex;align-items:flex-end;justify-content:space-between}
+  .hdr h2{font:900 48px/1 "Inter",sans-serif;letter-spacing:-.02em}
+  .hdr h2 b{display:inline-block;font-size:58px;padding-right:14px;background:linear-gradient(90deg,#f59e0b,#ff4d8d);-webkit-background-clip:text;background-clip:text;-webkit-text-fill-color:transparent}
+  .hdr .sub{font:600 16px/1 "JetBrains Mono","SF Mono",monospace;color:var(--muted);letter-spacing:.1em;text-transform:uppercase}
+  .grid{flex:1;display:grid;grid-template-columns:repeat(3,1fr);grid-template-rows:repeat(2,1fr);gap:20px;min-height:0}
+  .cell{position:relative;border-radius:20px;overflow:hidden;border:1px solid var(--line);box-shadow:0 20px 56px rgba(10,10,30,.12);background:#fff;min-height:0}
+  .cell.dark{background:#0a0a14;border-color:rgba(255,255,255,.08)}
+  .cell iframe{position:absolute;inset:0;width:1920px;height:1080px;border:0;pointer-events:none;transform-origin:top left}
+  .cell .label{position:absolute;left:16px;bottom:14px;z-index:5;font:700 12px/1 "JetBrains Mono","SF Mono",monospace;letter-spacing:.1em;padding:7px 14px;border-radius:999px;background:rgba(255,255,255,.94);color:#1a1a22;text-transform:uppercase;border:1px solid rgba(0,0,0,.06)}
+  .cell.dark .label{background:rgba(10,10,20,.78);color:#fff;border-color:rgba(255,255,255,.14)}
+</style>
+</head>
+<body>
+  <div class="hdr">
+    <h2><b>14</b>Full-Deck Templates — complete world-views</h2>
+    <div class="sub">html-ppt · templates/full-decks/* · pick 6 of 14</div>
+  </div>
+  <div class="grid" id="grid"></div>
+
+<script>
+const DECKS = [
+  ['graphify-dark-graph',true],
+  ['xhs-post',false],
+  ['hermes-cyber-terminal',true],
+  ['knowledge-arch-blueprint',false],
+  ['pitch-deck',false],
+  ['xhs-white-editorial',false]
+];
+const grid = document.getElementById('grid');
+DECKS.forEach(([name, dark]) => {
+  const cell = document.createElement('div');
+  cell.className = 'cell' + (dark ? ' dark' : '');
+  const ifr = document.createElement('iframe');
+  ifr.src = '../../templates/full-decks/' + name + '/index.html';
+  ifr.loading = 'eager';
+  cell.appendChild(ifr);
+  const lab = document.createElement('span');
+  lab.className = 'label';
+  lab.textContent = name;
+  cell.appendChild(lab);
+  grid.appendChild(cell);
+});
+
+function fit(){
+  document.querySelectorAll('.cell iframe').forEach(ifr => {
+    const c = ifr.parentElement;
+    const w = c.clientWidth, h = c.clientHeight;
+    const s = Math.min(w / 1920, h / 1080);
+    ifr.style.transform = 'scale('+s+')';
+    const sw = 1920*s, sh = 1080*s;
+    ifr.style.left = ((w - sw)/2) + 'px';
+    ifr.style.top  = ((h - sh)/2) + 'px';
+    ifr.style.position = 'absolute';
+  });
+}
+window.addEventListener('resize', fit);
+setTimeout(fit, 100);
+setTimeout(fit, 500);
+setTimeout(fit, 1500);
+</script>
+</body>
+</html>
diff --git a/docs/readme/montage-themes.html b/docs/readme/montage-themes.html
new file mode 100644
index 0000000..efe7fa9
--- /dev/null
+++ b/docs/readme/montage-themes.html
@@ -0,0 +1,38 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<title>36 themes showcase</title>
+<style>
+  :root{--ink:#0b0b10;--muted:#6b6b78;--line:#e7e7ef}
+  *{box-sizing:border-box;margin:0;padding:0}
+  html,body{width:1920px;height:1080px;overflow:hidden}
+  body{background:#f6f7fa;font-family:"PingFang SC","Noto Sans SC","Inter","SF Pro Display",-apple-system,sans-serif;color:var(--ink);padding:48px 56px 44px;display:flex;flex-direction:column;gap:28px}
+  .hdr{display:flex;align-items:flex-end;justify-content:space-between}
+  .hdr h2{font:900 48px/1 "Inter",sans-serif;letter-spacing:-.02em}
+  .hdr h2 b{display:inline-block;font-size:58px;padding-right:14px;background:linear-gradient(90deg,#7c5cff,#22d3ee);-webkit-background-clip:text;background-clip:text;-webkit-text-fill-color:transparent}
+  .hdr .sub{font:600 16px/1 "JetBrains Mono","SF Mono",monospace;color:var(--muted);letter-spacing:.1em;text-transform:uppercase}
+  .grid{flex:1;display:grid;grid-template-columns:repeat(4,1fr);grid-template-rows:repeat(2,1fr);gap:18px;min-height:0}
+  .cell{position:relative;border-radius:18px;overflow:hidden;border:1px solid var(--line);box-shadow:0 16px 48px rgba(10,10,30,.1);background:#fff;min-height:0}
+  .cell iframe{position:absolute;inset:0;width:100%;height:100%;border:0;pointer-events:none}
+  .cell .label{position:absolute;left:14px;bottom:12px;z-index:5;font:700 11px/1 "JetBrains Mono","SF Mono",monospace;letter-spacing:.1em;padding:6px 12px;border-radius:999px;background:rgba(255,255,255,.94);color:#1a1a22;text-transform:uppercase;border:1px solid rgba(0,0,0,.06)}
+  .cell.dark .label{background:rgba(10,10,20,.78);color:#fff;border-color:rgba(255,255,255,.14)}
+</style>
+</head>
+<body>
+  <div class="hdr">
+    <h2><b>36</b>Themes — one keyword, new identity</h2>
+    <div class="sub">html-ppt · assets/themes/*.css · pick 8 of 36</div>
+  </div>
+  <div class="grid">
+    <div class="cell"><iframe src="_theme-cell.html?theme=minimal-white"></iframe><span class="label">minimal-white</span></div>
+    <div class="cell dark"><iframe src="_theme-cell.html?theme=tokyo-night"></iframe><span class="label">tokyo-night</span></div>
+    <div class="cell dark"><iframe src="_theme-cell.html?theme=aurora"></iframe><span class="label">aurora</span></div>
+    <div class="cell"><iframe src="_theme-cell.html?theme=xiaohongshu-white"></iframe><span class="label">xiaohongshu-white</span></div>
+    <div class="cell dark"><iframe src="_theme-cell.html?theme=cyberpunk-neon"></iframe><span class="label">cyberpunk-neon</span></div>
+    <div class="cell dark"><iframe src="_theme-cell.html?theme=dracula"></iframe><span class="label">dracula</span></div>
+    <div class="cell"><iframe src="_theme-cell.html?theme=soft-pastel"></iframe><span class="label">soft-pastel</span></div>
+    <div class="cell"><iframe src="_theme-cell.html?theme=magazine-bold"></iframe><span class="label">magazine-bold</span></div>
+  </div>
+</body>
+</html>
diff --git a/docs/readme/templates.png b/docs/readme/templates.png
new file mode 100644
index 0000000..6b5b370
Binary files /dev/null and b/docs/readme/templates.png differ
diff --git a/docs/readme/themes.png b/docs/readme/themes.png
new file mode 100644
index 0000000..0dd9302
Binary files /dev/null and b/docs/readme/themes.png differ
