What problem does it solve?
Users get stuck on a blank page or endless splash screen when a CDN or browser caches a 404 for a content-hashed JavaScript boot chunk, and reloading cannot fix it because the client never revalidates the cached response.
Core Features & Use Cases
- Diagnosis confirmation: Distinguish a poisoned cache (404 with cf-cache-status HIT) from a genuinely missing origin file or an unrelated boot failure using curl header probes.
- Three-layer remediation: Apply the origin-side nginx no-store fix for 4xx/5xx responses, purge poisoned URLs at the Cloudflare edge, and understand why server-side fixes cannot reach clients holding immutable cached 404s.
- Asset URL rotation: Set the ASSET_CACHE_BUST repository variable so every emitted asset filename changes across all subsequent builds, since a plain redeploy leaves vendor chunk filenames byte-identical.
- Use Case: After a deploy, users report "spinner forever" and curl shows a cached 404 on rolldown-runtime-*.js; follow the runbook to confirm the poisoning, purge the edge, bump ASSET_CACHE_BUST to today's date, and verify recovery via curl and RUM.
Quick Start
Ask the assistant to diagnose whether users stuck on the splash screen are hitting a cached 404 on a boot asset and walk through the recovery steps.