Troubleshooting Sync & Conflicts Both

Procedures for diagnosing synchronization delays, resolving offline edit conflicts, and verifying real-time connection health.

Stalled Mutation Queue

If you see a yellow pending changes indicator that does not clear:

1. Open Settings → Sync to inspect the total count of pending mutations.
2. Click Sync Now (Web) or tap Force Sync (Android) to trigger an immediate queue flush.
3. If the connection remains offline due to captive portals or VPNs, queued changes remain safely saved in local storage (IndexedDB / Room) and will replay automatically once full internet connectivity is re-established.

Resolving Concurrent Edit Conflicts

When multiple collaborators edit the same task field while offline, TapTidy flags a conflict:

1. Navigate to the Conflicts screen (accessible via the conflict banner or at /app/conflicts).
2. Compare the Local Version and Server Version side-by-side.
3. Select which version to retain, or edit the fields directly to combine both updates.
4. Click Resolve Conflict to commit the reconciled state.

Reading the Sync Status Line

Both apps show a four-state sync summary — Settings → Sync on Android, the toolbar sync button on the desktop web app. Up to date and Catching up need no action. Offline means no validated connection (or offline mode is on) — changes queue locally and sync on reconnect. Attention needed means something requires you: a conflict to review (above) or changes that repeatedly failed to upload — open Settings → Sync on Android, or the Conflicts screen on the web app, to retry or dismiss them. See Instant Completion Sync for the full state definitions.

WebSocket & Firewall Issues

If real-time collaborator presence indicators or instant push updates are not displaying, your network firewall may be blocking secure WebSockets (wss://). TapTidy automatically degrades to HTTP polling to maintain synchronization.