comparison mrjunejune/PWA_SETUP.md @ 273:e02e2036ef84 default tip

add Layer 2 JRPG component system Add reusable content and window modals, an isolated component sandbox, shared cyberpunk scroll areas, production-safe cache freshness, and server-rendered JRPG panel state. Co-authored-by: Copilot <[email protected]>
author MrJuneJune <me@mrjunejune.com>
date Sat, 08 Aug 2026 02:08:08 -0700
parents 9c2eec61a152
children
comparison
equal deleted inserted replaced
272:41a49c29a28f 273:e02e2036ef84
56 ## Features 56 ## Features
57 57
58 ✅ **Offline Support** - Caches pages, CSS, JS, fonts, images 58 ✅ **Offline Support** - Caches pages, CSS, JS, fonts, images
59 ✅ **App Shortcuts** - Quick access to Blog and Notes 59 ✅ **App Shortcuts** - Quick access to Blog and Notes
60 ✅ **Install Prompt** - Automatic install button 60 ✅ **Install Prompt** - Automatic install button
61 ✅ **Auto-updates** - Service worker updates on reload 61 ✅ **Auto-updates** - New service workers activate and reload clients automatically
62 ✅ **Fast Loading** - Cached resources load instantly 62 ✅ **Fast Loading** - Cached resources load instantly
63 63
64 ## Customization 64 ## Customization
65 65
66 Edit `manifest.json` to change: 66 Edit `manifest.json` to change:
70 - `shortcuts` - App shortcut menu items 70 - `shortcuts` - App shortcut menu items
71 71
72 Edit `sw.js` to change: 72 Edit `sw.js` to change:
73 - `CACHE_VERSION` - Increment to force cache refresh 73 - `CACHE_VERSION` - Increment to force cache refresh
74 - `STATIC_CACHE` - Files to cache immediately 74 - `STATIC_CACHE` - Files to cache immediately
75 - Caching strategy (currently: cache-first with network fallback) 75 - Caching strategy:
76 - HTML, CSS, JS, JSON, and WASM are network-first with offline cache fallback.
77 - Fonts and images are stale-while-revalidate.
78 - Component sandbox assets always bypass service-worker caching.
79
80 Unversioned application code must not use cache-first. That can preserve stale
81 production CSS or JavaScript indefinitely when a deployment reuses the same URL.
76 82
77 ## Testing on Mobile 83 ## Testing on Mobile
78 84
79 ### Android: 85 ### Android:
80 1. Open Chrome 86 1. Open Chrome