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.

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.