robin/Dramlog-Prod
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: implement Paranoid Mode (SWR for Navigation)

Browse Source
This commit is contained in:
robin
2025-12-20 23:22:02 +01:00
parent a92b75891a
commit 8bafbf2ece
1 changed files with 4 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
OFFLINE_SYNC_PWA.md
View File

@@ -62,12 +62,12 @@ A critical feature is the ability to link tasting notes to a bottle that hasn't
## 📱 PWA Features ## 📱 PWA Features
### Service Worker (`public/sw.js`) - "Ironclad" Strategy ### Service Worker (`public/sw.js`) - "Paranoid Mode" Strategy
The Service Worker implements an aggressive offline reliability strategy: The Service Worker implements an extremely resilient "Cache-First, Network-Background" strategy for navigation:
- **Pre-Caching**: The landing page (`/`), core static assets, and the sessions overview (`/sessions`) are cached during installation. - **Pre-Caching**: The landing page (`/`), core static assets, and the sessions overview (`/sessions`) are cached during installation.
- **Fail-Fast Navigation**: Navigation requests have a 3-second timeout to prevent UI hangs during network transitions. - **SWR Navigation**: Navigation requests are handled with Stale-While-Revalidate. The SW serves the cached version immediately (instant load) and refreshes the cache in the background.
- **Root App Shell Fallback**: If a URL is not found in the cache while offline, the SW serves the Root (`/`). This allows Next.js to bootstrap and handle the routing client-side (including Scan and Note features embedded on the homepage) using local Dexie data. - **Universal Root Fallback**: If a URL is not found in the cache while offline, the SW serves the Root (`/`). This allows Next.js to bootstrap and handle the routing client-side (including Scan and Note features) using local Dexie data.
- **RSC Data Resiliency**: Requests to `/_next/data/` return an empty JSON object if they fail, preventing "Application Error" screens. - **RSC Data Resiliency**: Requests to `/_next/data/` return an empty JSON object if they fail, preventing "Application Error" screens.
- **Stale-While-Revalidate**: Applied to static assets to ensure immediate UI response. - **Stale-While-Revalidate**: Applied to static assets to ensure immediate UI response.