Offline-First Capacitor Apps

When to Use

TRIGGER when:

• The app must read and write while offline and sync later
• Choosing local storage (Preferences vs SQLite vs IndexedDB) for user data
• Writes are duplicated, lost, or overwritten during sync
• Cached data vanishes on iOS after low-storage events
• A service worker was added and native plugins stopped working (Plugin not implemented)

Do not use:

• Replacing @capacitor-community/sqlite / Ionic secure storage: sqlite-to-fast-sql
• Getting new web code to devices (OTA): capgo-live-updates
• Encryption key storage, SSL pinning: capacitor-security
• Query speed / bridge overhead tuning: capacitor-performance

Decisions (make these before writing code)