Summary: The mobile app does not automatically transition to offline mode when network connectivity is lost, resulting in failed sync attempts and error messages.
Symptoms
- App displays "Sync failed" or "Unable to connect" errors when connection drops
- Offline indicator in the top bar fails to appear despite no network access
- Work order edits appear to save, then revert on next sync attempt
- Manual refresh triggers (pull-to-refresh, sync button) hang indefinitely
Affected Versions
FieldPulse Mobile 3.1.0–3.1.4 on iOS 16+ and Android 13+
Cause
A regression in the connectivity detection library introduced in 3.1.0. The app relies on a reachability check that does not properly handle transitional network states (e.g., moving from WiFi to cellular, or brief signal drops in rural areas). When the check returns an ambiguous state, the offline mode trigger is not executed.
Workaround
Until the fix is released, users can manually enable offline mode:
- Tap Menu → Settings
- Toggle Force Offline Mode to On
- Work normally; data will queue for sync
- When connection is restored, toggle Force Offline Mode to Off
Note: This workaround requires manual intervention and may result in delayed sync if users forget to re-enable online mode. See Workaround: Manual Sync for Stale Mobile Data for additional recovery steps if sync issues persist.
Status
Fix targeted for 3.2.0 — currently in beta testing. Release expected October 2025.
Subscribe to this article for updates. For related guidance on offline workflows, see Our Commitment to Offline-First Field Operations and FieldPulse Now Supports Offline Mode on iOS and Android.
