Sync and Offline

Harmonise uses three related but different systems:

1. Harmonise account sync carries profile, calendar, Event, and Task changes between signed-in clients.
2. External provider sync exchanges supported Event changes with Google, Outlook, Apple, Yahoo, or compatible CalDAV calendars.
3. Local cached and offline behavior controls what the current device or browser can show or save without a connection.

What Harmonise synchronizes

When a client starts, it loads the current account state and then retrieves newer changes. Later checks can pull only what changed. This supports multiple devices, but one device may need a manual refresh before a recent change appears.

The mobile sync sheet and web Sync panel can turn account sync off or on for the current device or browser. Turning it off does not sign you out, disconnect calendar integrations, delete cloud data, or remove cached information. Pending supported changes remain on that device until sync is turned on again.

When synchronization happens

Both clients check during startup and app or browser resume. A restored network connection can trigger another check. Do not assume that every device refreshes at the same instant; use the visible sync status and a manual refresh when verifying a recent change.

External provider synchronization can take additional time. See Manage connected calendars for provider Event synchronization and calendar-list refreshes.

Sync on mobile

Pull down on Home to request fresh visible Events and Tasks. The Home sync status can show a relative Synced time, Offline, Sync issue, Cached data, Syncing, Uploading changes, a pending count, or Needs review. Open Sync to see Cloud sync for this device, Pending changes, Conflicts, Connection, and Last synced.

The mobile sync sheet can show enabled, disabled, checking, and unavailable states. It offers Sync now, Try syncing again, Refresh visible data, Check connection again, Fetch latest conflict status, and Retry checking this device when those actions apply. It can turn sync on or off for the device; turning it off asks for confirmation and keeps pending changes on the device.

Mobile can detect a conflict and fetch its latest status, but it does not provide a screen for choosing between two versions.

Refresh on web

Open the Sync control to see the last sync time, connection state, pending changes, conflicts, and whether sync is enabled for that browser. Choose Sync now to push pending supported changes and retrieve newer account data. The panel also provides retry, enable, disable, and conflict-review actions when applicable.

What remains available offline

Both clients can reopen account-owned profile, calendar, Event, and Task information that was previously cached on that client. Coverage depends on what was loaded before the connection was lost. A cached view is not proof that it is the latest server version.

Provider discovery, provider Event refresh, profile saves, and most first-time loads require a connection.

Pending changes

On web, supported Event and Task creates, updates, and deletes are saved to durable browser storage before upload. The UI can show Pending changes or a pending count. The browser can close and reopen with those changes still pending, provided its site data is preserved. They upload when sync is enabled and a connection succeeds.

On mobile, current Event and Task actions may appear in the pending count only when they use the sync mutation flow. Treat a direct save as saved only after the action finishes successfully; if it fails offline, reconnect and repeat the action once.

Sync conflicts

Web provides user-facing conflict review. Open Sync, review each conflict, and choose Keep local or Keep server. After the choice succeeds, synchronize again if the panel still shows pending work.

Mobile can show Needs review and refresh conflict status but cannot choose a version. Use web for a user-resolvable conflict or avoid further edits to the same item until the conflict is resolved.

Protecting your data

On web, do not clear browser site data, use private browsing as long-term storage, or sign out while important changes remain pending. Wait for the pending count to reach zero and a successful sync time to appear. Disabling sync is not cloud deletion; the inspected clients do not expose cloud-data deletion as a normal Settings action.

On mobile, do not assume an erroring save will upload later. Reconnect, reopen the item, and retry deliberately.

Troubleshooting

See Troubleshoot sync and offline use for stale data, failed offline saves, pending web changes, conflict review, and refresh errors.