benstull/human-experience-filter-art
1
0
Fork 0
Code Issues 2 Pull Requests 1 Actions Packages Projects Releases Wiki Activity

chore(deploy): no-store the app-shell HTML (stop Safari serving a stale index)

Browse Source 
no-cache (revalidate) wasn't enough — Safari served a stale cached index from
disk/bfcache, which loaded old versioned JS and broke the page (black, silent).
HTML entry points now no-store (always fresh index → always fresh hashed assets).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
BenStullsBets
2026-06-30 14:12:57 -07:00
parent ccd40103a2
commit e06191db32
1 changed files with 13 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files
tools/build_static.py
+13 -8
View File
@@ -69,14 +69,19 @@ def _write_redirects(out: Path, seg: str) -> None:
def _write_headers(out: Path, seg: str) -> None:
# The app shell (html/js/json) must NOT be browser-cached — otherwise a deploy is
# invisible to returning visitors for hours (Pages' default is max-age=14400).
# `no-cache` = store but revalidate every load (cheap 304 via etag). The media is
# on R2 (immutable + content-hash), unaffected. Cloudflare Pages `_headers` syntax.
(out / "_headers").write_text(
f"/{seg}/*\n"
" Cache-Control: no-cache\n"
)
# The app shell must NOT be browser-cached — otherwise a deploy is invisible to
# returning visitors for hours (Pages' default is max-age=14400). The HTML entry
# points get `no-store` (never stored → a guaranteed-fresh index every visit):
# `no-cache` (revalidate) was not enough — Safari served a STALE index from its
# disk/bfcache, which then loaded the OLD versioned JS and broke the page. A fresh
# index is the linchpin: it carries the content-hashed asset URLs (see
# _version_assets), so once the HTML is fresh the JS/CSS are too. The rest of the
# app path stays `no-cache`. Media is on R2 (immutable + content-hash), unaffected.
# Cloudflare Pages `_headers` syntax; later rules win for the same header.
html_pages = ("", "index.html", "credits.html", "about.html") # "" = the /seg/ root
blocks = [f"/{seg}/*\n Cache-Control: no-cache\n"]
blocks += [f"/{seg}/{p}\n Cache-Control: no-store\n" for p in html_pages]
(out / "_headers").write_text("".join(blocks))
def _version_assets(app_dir: Path) -> None: