Capacitor Offline First

This is your blueprint for building Capacitor apps that work offline. It covers the full stack: network detection with the Capacitor Network plugin, local storage with Fast SQL, and a complete sync manager that handles pending changes and conflict resolution. The architecture is practical, separating online/offline modes with a service layer that transparently falls back to cached data. Worth noting that Fast SQL requires platform-specific setup (localhost networking on iOS, cleartext exceptions on Android), so budget time for that. The sync strategy is timestamp-based with soft deletes, which works for most apps but might need adjustment if you have complex multi-user conflict scenarios.

skills.sh installs: 1.1K
GitHub stars: 77
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add cap-go/capgo-skills --skill capacitor-offline-first --agent claude-code

Installs into .claude/skills of the current project.

Files

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