Skip to main content

Service-worker caching contract (HTML network-only, kill switch)

The custom service worker precaches the hashed build and icons, serves HTML and __data.json network-only while never intercepting /api/* or SSE, and ships a…

Service-worker caching contract (HTML network-only, kill switch)

Generated from mcp/patterns.registry.json — do not edit by hand; change the registry and run bun run patterns:build.

Index card — the docs below are the canonical explanation; deep-tier pattern pages additionally carry invariants and emulation notes.

Category: PWA · Tier: light · Risk: medium — touches deploy config and can affect every installed client if misconfigured

The custom service worker precaches the hashed build and icons, serves HTML and __data.json network-only while never intercepting /api/* or SSE, and ships a kill switch that force-wipes caches and unregisters on a bad deploy.

When to use: Use when you need an installable offline shell without caching personalized HTML, plus a documented recovery path for a broken worker.

Docs

Code

Proof

Machine-readable record: pwa-service-worker in mcp/patterns.registry.json.

← Back to Pattern Library

Think this pattern could be better? Tell us how.

Leave feedback