Offline mode
Enable read-write while offline; sync when reconnected.
Overview
Offline mode lets staff continue working when the internet drops. Local changes queue; when connection returns, they sync. Best for clinics in areas with unstable connectivity.
Prerequisites
- Owner or Admin role
offline_supportfeature flag (Professional+)- Modern browser (Chrome, Edge, Firefox, Safari current versions)
Steps
Open Offline settings. Settings → Offline.
Enable offline mode. Toggle on. Browser prompts for storage permission — accept.
Wait for initial sync. First-time enables download a local copy of recent patient data. Progress shown.
Test by going offline. Disable wifi/network; the app stays usable. A yellow banner appears: "You're offline. Changes will sync when reconnected."
Make changes offline. Create patients, book appointments, write notes — all work. Changes show with a queued indicator.
Reconnect. Network restored; the app auto-syncs queued changes. Each sent change shows a green checkmark.
Resolve conflicts if any. When two users edited same record — yours offline, theirs online — a merge UI appears showing both versions. Pick one or merge field-by-field.
Disable offline mode. Toggle off. Local data is cleared; no sync needed.
Expected outcome
- App remains usable during network outages
- All local changes sync on reconnect
- Conflicts surface with a clear resolution UI
Troubleshooting
| Symptom | Likely cause | Fix |
|---|---|---|
| Storage permission denied | Browser blocked | Allow in browser settings |
| Sync never completes | Stale local copy | Disable, re-enable to fresh-fetch |
| Conflicts on every record | Local clock wrong | Sync system clock |
| Some changes lost | Browser crashed before sync | Best-effort recovery; check audit log |
| Want offline on phone | Patient portal already supports limited offline | Clinic app on mobile not officially supported |