Architecture
Design decisions and rationale behind Swoff's architecture.
The architecture guides explain the design decisions behind Swoff's offline-first system.
Hybrid SW + Client Model
Why Swoff splits responsibilities between service worker and client scopes.
Precaching
Background activation-first precaching with IndexedDB checkpoint resume and progress reporting.
Caching System
Reactive strategy, staleTime, HTML cache isolation, 3-tier config resolution.
Data Sync
Request batching, refresh queue, mutation queue, online recovery.
GraphQL & Server Push
Body-hash GraphQL caching, SSE/WebSocket, tag invalidation.
Auth System
Auth adapter plugin system, memory-only tokens, cross-tab sync.
Observability
Resource monitoring, fetch timeout, storage quota awareness.
Optimistic Updates
Why Swoff deliberately excludes optimistic updates — design rationale.