diff --git a/trending-template.html b/trending-template.html
new file mode 100644
index 0000000..7c70edc
--- /dev/null
+++ b/trending-template.html
@@ -0,0 +1,27 @@
+<!doctype html><html lang="en"><head>
+<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<title>notplanned / trending</title>
+<meta name="description" content="Deterministic GitHub Trending feed: daily, weekly, monthly.">
+<style>
+:root{color-scheme:light dark;--bg:#f3f1eb;--fg:#111;--muted:#6d6961;--line:#cbc7bc;--card:#faf8f2;--accent:#ff5a1f}
+@media(prefers-color-scheme:dark){:root{--bg:#10100f;--fg:#f2efe7;--muted:#a6a198;--line:#393732;--card:#171715;--accent:#ff7540}}
+*{box-sizing:border-box}body{margin:0;background:var(--bg);color:var(--fg);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono",monospace}a{color:inherit}.wrap{width:min(1180px,calc(100% - 36px));margin:auto}
+header{min-height:76px;border-bottom:1px solid var(--line);display:flex;align-items:center;justify-content:space-between;gap:16px}.brand{font-weight:900;letter-spacing:-.05em}.nav{font-size:11px;color:var(--muted);display:flex;gap:14px}.nav a{text-decoration:none}
+.hero{padding:74px 0 45px;display:grid;grid-template-columns:1.3fr .7fr;gap:40px;align-items:end}h1{font-family:ui-sans-serif,system-ui,sans-serif;font-size:clamp(58px,10vw,112px);line-height:.85;letter-spacing:-.08em;margin:0}.dek{font-family:ui-sans-serif,system-ui,sans-serif;color:var(--muted);font-size:18px;line-height:1.45;margin:0}
+.stats{display:grid;grid-template-columns:repeat(4,1fr);border:1px solid var(--line);border-radius:16px;overflow:hidden;margin-bottom:22px}.stat{padding:16px;border-right:1px solid var(--line)}.stat:last-child{border:0}.stat strong{display:block;font-family:ui-sans-serif,system-ui,sans-serif;font-size:22px}.stat span{font-size:9px;color:var(--muted);text-transform:uppercase;letter-spacing:.1em}
+.note{font-size:11.5px;color:var(--muted);line-height:1.5;margin:0 0 24px}.grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:12px;margin-bottom:60px}.repo-card{display:flex;flex-direction:column;min-height:210px;text-decoration:none;background:var(--card);border:1px solid var(--line);border-radius:17px;padding:19px;transition:.12s ease}.repo-card:hover{transform:translateY(-2px);border-color:var(--fg)}.repo-top{display:flex;justify-content:space-between;gap:16px;align-items:start}.repo-card h3{font-family:ui-sans-serif,system-ui,sans-serif;font-size:21px;letter-spacing:-.035em;margin:0}.period-count{color:var(--accent);font-weight:800}.repo-card p{font-family:ui-sans-serif,system-ui,sans-serif;font-size:14px;line-height:1.45;color:var(--muted);margin:15px 0 auto}.badges{display:flex;flex-wrap:wrap;gap:6px;margin-top:18px}.badge{border:1px solid var(--line);border-radius:999px;padding:5px 7px;font-size:10px}.lang{border-top:1px solid var(--line);padding-top:10px;margin-top:13px;font-size:10px;color:var(--muted)}
+footer{border-top:1px solid var(--line);padding:24px 0 36px;display:flex;justify-content:space-between;color:var(--muted);font-size:11px}
+@media(max-width:780px){.hero{grid-template-columns:1fr}.grid{grid-template-columns:1fr}.stats{grid-template-columns:1fr 1fr}.stat:nth-child(2){border-right:0}.stat:nth-child(-n+2){border-bottom:1px solid var(--line)}}
+</style></head><body><div class="wrap">
+<header><div class="brand">notplanned / trending</div><div class="nav"><a href="/">scout</a><a href="/trending.json">trending.json</a><a href="https://github.com/trending" target="_blank">source ↗</a></div></header>
+<section class="hero"><h1>what's hot.</h1><p class="dek">A deterministic mirror of GitHub Trending. Daily, weekly, and monthly lists are fetched directly from GitHub, merged by repository, and left uninterpreted.</p></section>
+<section class="stats">
+<div class="stat"><strong>__DAILY__</strong><span>daily</span></div>
+<div class="stat"><strong>__WEEKLY__</strong><span>weekly</span></div>
+<div class="stat"><strong>__MONTHLY__</strong><span>monthly</span></div>
+<div class="stat"><strong>__OVERLAP__</strong><span>in 2+ windows</span></div>
+</section>
+<p class="note">Updated __UPDATED__ UTC. Badges preserve GitHub's rank for each time window and, when GitHub exposes it, stars gained in that window. “2/3” or “3/3” means the repo appears across multiple Trending windows; it is not an AI score.</p>
+<section class="grid">__CARDS__</section>
+<footer><span>notplanned · trending feed</span><span>source: github.com/trending</span></footer>
+</div></body></html>
\ No newline at end of file