diff --git a/CHANGELOG.md b/CHANGELOG.md
index 32daadb..b90b8ae 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -58,6 +58,10 @@ All notable user-visible changes to this project are documented in this file.
   shown on focus, the editable session title is labeled and Escape cancels
   an edit, snippet iframes carry the snippet title, and toasts are announced
   via a polite live region.
+- Following the README quick start from a git clone failed: `npx sideshow
+serve` exited with `viewer build missing` because nothing built the viewer.
+  `npm install` in the repo now builds it (the published npm package was
+  unaffected — `prepack` already ships a built viewer).
 
 ## [0.2.0] - 2026-06-11
 
diff --git a/package.json b/package.json
index 48c5bd9..0d63a52 100644
--- a/package.json
+++ b/package.json
@@ -48,7 +48,7 @@
     "deploy": "npm run build:viewer && wrangler deploy",
     "dev:cloud": "npm run build:viewer && wrangler dev",
     "prepack": "npm run build",
-    "prepare": "simple-git-hooks"
+    "prepare": "simple-git-hooks && npm run build:viewer"
   },
   "dependencies": {
     "@hono/node-server": "^1.14.0",