Sync Issues

Solutions for offline mode and data synchronization problems.

Understanding Sync

How Sync Works

1. Online Mode: Changes save immediately to server
2. Offline Mode: Changes stored locally on device
3. Sync: Local changes upload when connection restored

Sync Status Indicators

Indicator	Meaning
✓ Synced	All data up to date
⟳ Syncing	Currently uploading/downloading
! Pending	Changes waiting to sync
✕ Error	Sync failed

Common Sync Problems

Data Not Syncing

Symptoms:

• Pending indicator persists
• Changes not appearing on other devices
• Sync stuck

Solutions:

1. Check internet connection

   • Verify you're online
   • Try loading a website
   • Check Wi-Fi/mobile data

2. Force sync

   • Pull down to refresh
   • Or click sync button
   • Wait for completion

3. Restart the app

   • Close completely
   • Reopen and check

4. Check sync status

   • Look for error messages
   • Note any specific errors

Sync Taking Too Long

Symptoms:

• Sync spinner for extended time
• Progress stuck
• Very slow uploads

Solutions:

1. Check connection speed

   • Slow connection = slow sync
   • Try better network

2. Reduce pending data

   • Large photos slow sync
   • Many items queue up

3. Wait for completion

   • Don't close during sync
   • Let it finish

4. Sync incrementally

   • Don't wait too long offline
   • Sync periodically

Sync Errors

Symptoms:

• Error messages appear
• Red indicator
• Failed sync notification

Common Errors:

Error	Cause	Solution
Network error	No connection	Check internet
Timeout	Slow connection	Try again on better network
Conflict	Data changed elsewhere	Resolve conflict
Server error	System issue	Wait and retry
Auth error	Session expired	Log in again

Conflict Resolution

What Are Conflicts

Conflicts occur when:

• Same data edited in two places
• Offline changes conflict with server changes
• Multiple users edit same item

Resolving Conflicts

When conflict detected:

1. Review both versions

   • Your local changes
   • Server version

2. Choose resolution

   • Keep local version
   • Keep server version
   • Merge manually

3. Confirm

   • Selection applied
   • Conflict cleared

Preventing Conflicts

1. Sync frequently

   • Don't stay offline too long
   • Sync before editing

2. Coordinate with team

   • Communicate about edits
   • Avoid simultaneous changes

3. Work on assigned items

   • Reduces overlap

Offline Mode Issues

Offline Mode Not Working

Symptoms:

• Can't access data offline
• App requires connection
• Features unavailable

Solutions:

1. Enable offline mode

   • Settings > Offline Mode
   • Toggle on

2. Pre-load data

   • Open items while online
   • Data cached for offline

3. Check storage space

   • Device needs space
   • Clear unused data

4. Update app

   • Latest version needed
   • Check for updates

Limited Offline Features

Some features require internet:

Available Offline	Requires Online
View cached items	Search all items
Perform inspections	Generate reports
View recent history	Access admin features
Take photos	Send notifications

Offline Data Missing

Symptoms:

• Items not available offline
• Partial data only
• "Not cached" messages

Solutions:

1. Cache data while online

   • Open items you need
   • Browse through lists
   • Data stored locally

2. Configure offline settings

   • Settings > Offline
   • Choose what to cache

3. Ensure enough storage

   • Clear device storage
   • Remove unused apps

Mobile Sync Issues

App Won't Sync

Solutions:

1. Check app permissions

   • Network access allowed
   • Background data enabled

2. Check battery optimization

   • App not restricted
   • Allow background activity

3. Force sync

   • Pull down to refresh
   • Check Settings > Sync

Photos Not Uploading

Symptoms:

• Inspection photos stuck
• Upload progress not moving
• Photo sync failed

Solutions:

1. Check file size

   • Very large photos take longer
   • Compression may help

2. Check connection

   • Photos need good upload speed
   • Use Wi-Fi if possible

3. Retry upload

   • Find pending photos
   • Tap to retry

4. Check storage permissions

   • App needs storage access
   • Re-grant if needed

Background Sync Stopped

Symptoms:

• Only syncs when app open
• Background not working
• Notifications not updating

Solutions:

1. Disable battery saver

   • May stop background activity

2. Allow background refresh

   • iOS: Settings > App > Background Refresh
   • Android: Settings > Apps > Battery > Unrestricted

3. Keep app updated

   • Updates fix sync issues

Browser Sync Issues

Data Not Persisting

Symptoms:

• Data lost after closing browser
• Need to reload each time
• Offline mode not working

Solutions:

1. Don't use private/incognito

   • Data can't persist
   • Use normal mode

2. Allow local storage

   • Browser settings
   • Enable for Kuviq site

3. Don't clear site data

   • Clearing removes cached data
   • Re-sync needed after clearing

Multiple Tabs Conflict

Symptoms:

• Different data in different tabs
• Changes not reflecting
• Inconsistent state

Solutions:

1. Use single tab

   • Multiple tabs can conflict
   • Close extras

2. Refresh all tabs

   • After making changes
   • Sync state

3. Close and reopen

   • Single fresh tab
   • Load latest data

Recovery Steps

If Sync Completely Fails

1. Note pending changes

   • Screenshot if needed
   • Record what was done

2. Log out

   • Clear local session

3. Clear app/browser data

   • Remove cached data
   • Fresh start

4. Log back in

   • Re-sync from server
   • Re-enter any lost changes

Data Recovery

If data appears lost:

1. Check sync status

   • May still be pending
   • Wait for sync to complete

2. Check other devices

   • May have synced elsewhere

3. Contact support

   • Provide details
   • May be recoverable

Best Practices

For Reliable Sync

1. Sync before going offline
2. Sync immediately when back online
3. Don't edit same item from multiple devices
4. Keep app updated
5. Maintain stable connection during sync

For Working Offline

1. Plan ahead - cache needed data
2. Complete work in sessions
3. Sync when possible
4. Monitor pending count
5. Address errors promptly

Related Topics

• Offline Inspections - Working offline
• Common Issues - General troubleshooting
• Login Issues - Authentication problems