// the find
jakearchibald/simple-serviceworker-tutorial
A really simple ServiceWorker example, designed to be an interactive introduction to ServiceWorker
A step-by-step interactive tutorial for learning Service Workers, written by Jake Archibald (who literally co-wrote the SW spec). You run it locally, follow numbered exercises in the README, and make changes to see how fetch interception, caching, and update lifecycles work. Aimed at frontend developers who learn by doing rather than reading docs.
The progression is well-designed — you start with offline caching, then hit the update-waiting behavior head-on, which is the part that trips everyone up. No build step means you read actual SW code, not transpiled output. The reset page (unregisters SW + clears caches) is a small but thoughtful addition that saves real frustration during local experimentation. Archibald's authorship means the conceptual framing is accurate.
Last touched in 2016 — `skipWaiting` is now unconditional (no Chrome 40 guard needed), and `clients.claim()` isn't mentioned, leaving a gap in the lifecycle explanation. Uses a polyfill for Cache API that modern browsers don't need. No coverage of Background Sync, Push, or Workbox, so it tops out exactly where real-world complexity begins. The tutorial format means there's nothing reusable here for an actual project.