iCloud & devices

Synchronize supported records with iCloud

Enable iCloud synchronization, understand what moves between devices, and troubleshoot records that differ.

BeFit Tracker uses iCloud to reconcile supported personal records between configured Apple devices. It synchronizes mutable information such as logs, goals, settings, and tracker history; each device continues to read the bundled food catalog from its own local, read-only copy.

iPhone

On iPhone, Profile shows iCloud beside the Health connection and account controls.

iPad

On iPad, connection state appears in the Profile dashboard.

Mac

On Mac, Profile reports the account and synchronization state used by personal records.

Before enabling synchronization

1. Confirm every participating device is signed in to the intended Apple Account.
2. Make sure iCloud is available for that account and each device has network access.
3. Open BeFit Tracker on each device and check that the records you care about are visible locally.
4. Avoid making competing corrections to the same record on several devices during initial setup.

Turn on Sync with iCloud

1. Open Profile and find the iCloud connection card.
2. Enable Sync with iCloud.
3. Keep BeFit Tracker open and online while the initial download, reconciliation, and upload finish.
4. Repeat on the other device, then verify several known records by tracker and date rather than checking only a dashboard total.

What synchronization includes

Supported domains include food logs, water, personal foods and recipes, favorites, collections, weight, BMI, beta-tracker records, profile settings and goals, achievements, and supported steps. iPhone and iPad publish supported Apple Health-sourced steps; Mac consumes those reconciled records rather than connecting to HealthKit itself.

Synchronization is reconciliation, not blind copying.

BeFit Tracker compares stable record identities, modification times, source-device identifiers, and deletion state. A sync can download, merge, upload, acknowledge, and fetch again before every device converges.

If iCloud is disconnected or unavailable

1. Confirm the device is signed in to the expected Apple Account.
2. Check iCloud availability and network access in Apple system settings.
3. Return to Profile and check the iCloud status again.
4. Reopen BeFit Tracker after correcting account or network settings.

An Apple service or account error is outside BeFit Tracker’s control. Do not delete the app to refresh the connection; deletion can remove local records without removing cloud records.

If one record differs between devices

1. Identify the exact tracker, date, and expected value on each device.
2. Check date, time, and time-zone differences, especially for timed sessions and overnight sleep.
3. Keep both devices online with synchronization enabled and allow the current cycle to finish.
4. Do not create a duplicate while waiting.
5. On Mac, open CloudKit Logs and export the attempt if the mismatch persists.

How conflicts are resolved

BeFit Tracker resolves a record as a whole using its modification information and deterministic tie-breaking, including deletion state. It does not merge individual fields from two competing edits. Make one correction on one device, let it synchronize, and then confirm the result elsewhere.

What iCloud Sync does not do

• It does not replace the local bundled food catalog with a cloud database.
• It does not make Mac a direct Apple Health reader.
• It does not guarantee instant replication while a device is offline or Apple services are unavailable.
• It does not make app deletion a safe reset strategy.

For persistent Mac issues, follow Inspect, export, or reset iCloud synchronization on Mac.