subwaymatch · Oct 16, 2026 · Oct 16, 2026
diff --git a/docs/api.html b/docs/api.html
@@ -10,8 +10,8 @@
 <link rel="preconnect" href="https://fonts.googleapis.com">
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
 <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=DM+Mono:ital,wght@0,400;0,500;1,400&amp;family=Schibsted+Grotesk:wght@400;500;600&amp;family=Besley:wght@400;500;600&amp;display=swap">
-<link rel="stylesheet" href="assets/site.css">
-<script src="assets/site.js" defer></script>
+<link rel="stylesheet" href="assets/site.css?v=16ecc1ba1e">
+<script src="assets/site.js?v=66727f1611" defer></script>
 </head>
 <body>
 <header class="mobilebar">

diff --git a/docs/blend-modes.html b/docs/blend-modes.html
@@ -10,8 +10,8 @@
 <link rel="preconnect" href="https://fonts.googleapis.com">
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
 <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=DM+Mono:ital,wght@0,400;0,500;1,400&amp;family=Schibsted+Grotesk:wght@400;500;600&amp;family=Besley:wght@400;500;600&amp;display=swap">
-<link rel="stylesheet" href="assets/site.css">
-<script src="assets/site.js" defer></script>
+<link rel="stylesheet" href="assets/site.css?v=16ecc1ba1e">
+<script src="assets/site.js?v=66727f1611" defer></script>
 </head>
 <body>
 <header class="mobilebar">

diff --git a/docs/examples.html b/docs/examples.html
@@ -10,8 +10,8 @@
 <link rel="preconnect" href="https://fonts.googleapis.com">
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
 <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=DM+Mono:ital,wght@0,400;0,500;1,400&amp;family=Schibsted+Grotesk:wght@400;500;600&amp;family=Besley:wght@400;500;600&amp;display=swap">
-<link rel="stylesheet" href="assets/site.css">
-<script src="assets/site.js" defer></script>
+<link rel="stylesheet" href="assets/site.css?v=16ecc1ba1e">
+<script src="assets/site.js?v=66727f1611" defer></script>
 </head>
 <body>
 <header class="mobilebar">

diff --git a/docs/index.html b/docs/index.html
@@ -10,8 +10,8 @@
 <link rel="preconnect" href="https://fonts.googleapis.com">
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
 <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=DM+Mono:ital,wght@0,400;0,500;1,400&amp;family=Schibsted+Grotesk:wght@400;500;600&amp;family=Besley:wght@400;500;600&amp;display=swap">
-<link rel="stylesheet" href="assets/site.css">
-<script src="assets/site.js" defer></script>
+<link rel="stylesheet" href="assets/site.css?v=16ecc1ba1e">
+<script src="assets/site.js?v=66727f1611" defer></script>
 </head>
 <body>
 <header class="mobilebar">

diff --git a/docs/operations.html b/docs/operations.html
@@ -10,8 +10,8 @@
 <link rel="preconnect" href="https://fonts.googleapis.com">
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
 <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=DM+Mono:ital,wght@0,400;0,500;1,400&amp;family=Schibsted+Grotesk:wght@400;500;600&amp;family=Besley:wght@400;500;600&amp;display=swap">
-<link rel="stylesheet" href="assets/site.css">
-<script src="assets/site.js" defer></script>
+<link rel="stylesheet" href="assets/site.css?v=16ecc1ba1e">
+<script src="assets/site.js?v=66727f1611" defer></script>
 </head>
 <body>
 <header class="mobilebar">

diff --git a/docs/previews/brightness.jpg b/docs/previews/brightness.jpg
diff --git a/docs/previews/chaining.jpg b/docs/previews/chaining.jpg
diff --git a/docs/previews/color_burn.jpg b/docs/previews/color_burn.jpg
diff --git a/docs/previews/color_dodge.jpg b/docs/previews/color_dodge.jpg
diff --git a/docs/previews/contrast.jpg b/docs/previews/contrast.jpg
diff --git a/docs/previews/curve_red.jpg b/docs/previews/curve_red.jpg
diff --git a/docs/previews/curve_rgb.jpg b/docs/previews/curve_rgb.jpg
diff --git a/docs/previews/darken.jpg b/docs/previews/darken.jpg
diff --git a/docs/previews/grayscale.jpg b/docs/previews/grayscale.jpg
diff --git a/docs/previews/hard_light.jpg b/docs/previews/hard_light.jpg
diff --git a/docs/previews/hue.jpg b/docs/previews/hue.jpg
diff --git a/docs/previews/lighten.jpg b/docs/previews/lighten.jpg
diff --git a/docs/previews/lightness.jpg b/docs/previews/lightness.jpg
diff --git a/docs/previews/linear_burn.jpg b/docs/previews/linear_burn.jpg
diff --git a/docs/previews/linear_dodge.jpg b/docs/previews/linear_dodge.jpg
diff --git a/docs/previews/linear_light.jpg b/docs/previews/linear_light.jpg
diff --git a/docs/previews/multiply.jpg b/docs/previews/multiply.jpg
diff --git a/docs/previews/overlay.jpg b/docs/previews/overlay.jpg
diff --git a/docs/previews/pin_light.jpg b/docs/previews/pin_light.jpg
diff --git a/docs/previews/resize.jpg b/docs/previews/resize.jpg
diff --git a/docs/previews/saturation.jpg b/docs/previews/saturation.jpg
diff --git a/docs/previews/screen.jpg b/docs/previews/screen.jpg
diff --git a/docs/previews/soft_light.jpg b/docs/previews/soft_light.jpg
diff --git a/docs/previews/vivid_light.jpg b/docs/previews/vivid_light.jpg
diff --git a/scripts/docs_layout.py b/scripts/docs_layout.py
@@ -8,9 +8,12 @@
 
 from __future__ import annotations
 
+import hashlib
 import html
 import re
 from dataclasses import dataclass
+from functools import cache
+from pathlib import Path
 
 REPO_URL = "https://github.com/subwaymatch/layer-is-python"
 
@@ -37,6 +40,20 @@ class Page:
 # The Layer.is logo (docs/assets/logo.svg), used in the sidebar and as favicon.
 LOGO = "assets/logo.svg"
 
+ASSETS_DIR = Path(__file__).resolve().parent.parent / "docs" / "assets"
+
+
+@cache
+def asset_url(name: str) -> str:
+    """URL of a file in docs/assets/ with a hash of its contents appended.
+
+    GitHub Pages serves assets under fixed names with a 10-minute cache, so
+    without this a browser can pair a freshly built page with a stale
+    stylesheet. The hash gives every version of a file its own URL.
+    """
+    digest = hashlib.sha256((ASSETS_DIR / name).read_bytes()).hexdigest()[:10]
+    return f"assets/{name}?v={digest}"
+
 # GitHub's "mark-github" octicon (MIT licensed, github.com/primer/octicons).
 GITHUB_ICON = (
     '<svg viewBox="0 0 16 16" width="15" height="15" fill="currentColor" aria-hidden="true">'
@@ -266,8 +283,8 @@ def page(
 <link rel="preconnect" href="https://fonts.googleapis.com">
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
 <link rel="stylesheet" href="{esc(FONTS_URL)}">
-<link rel="stylesheet" href="assets/site.css">
-<script src="assets/site.js" defer></script>
+<link rel="stylesheet" href="{asset_url("site.css")}">
+<script src="{asset_url("site.js")}" defer></script>
 </head>
 <body>
 <header class="mobilebar">

diff --git a/scripts/generate_previews.py b/scripts/generate_previews.py
@@ -35,7 +35,7 @@
 
 import docs_layout as layout  # noqa: E402  (sibling module in scripts/)
 
-DEFAULT_SOURCE = REPO_ROOT / "docs" / "photos" / "gamcheon-village.jpg"
+DEFAULT_SOURCE = REPO_ROOT / "docs" / "photos" / "hanbok-portrait.jpg"
 PANEL_WIDTH = 480  # width of each before/after panel
 GUTTER = 4  # white gap between the two panels
 JPEG_QUALITY = 82