Guides

Where the Reference describes what things are, Guides are task-oriented: how to actually get something done. They form a progression from your first PWA through the harder problems, and link back into the Reference and Compatibility data for the authoritative detail.

The learning path

Work top to bottom: each guide assumes the outcome of the one before it.

Getting startedBuild and ship your first installable PWA end to end: add a manifest, register a service worker, and meet the installability bar.

Make it installableGo beyond the minimum bar: meet every installability criterion and design an install moment that earns the add-to-home-screen.

Offline strategiesMake a PWA load and stay usable with no network: precache the shell, route each fetch by request type, clean up old caches, and serve an offline fallback page.

PerformanceMeasure LCP, INP, and CLS in the field, reproduce the slow page in Lighthouse, fix each metric, precache the shell, and guard the result with Lighthouse CI.

AdvancedProduction-grade capabilities (push, file access, platform integration) added as progressive enhancement with a compatibility check at every step.

Debug a PWAHow to use the Chrome DevTools Application panel (Manifest, Service workers, Cache storage) to inspect and troubleshoot a PWA while developing it.

Add app shortcutsAdd shortcuts entries to a PWA manifest so the installed app's icon offers quick actions, keep every URL in scope, and mirror the menu inside the app.

How guides relate to the rest of the site

Guides are the how. They never restate the facts that live elsewhere:

• For what a thing is and how it behaves, guides link into the Reference.
• For where it works, guides link into the Compatibility data.

That keeps the facts in one place: a guide tells you the steps and cites the reference entry or support matrix for the detail, so guidance never drifts from the facts. Every guide carries sources and a lastVerified date, and is written to stay current: it teaches a durable task, not a dated announcement.