← Back to Wiki

DATA MANAGEMENT

Google Drive Sync

Google Drive Sync V2 keeps a selected FuelLens workspace current across devices. FuelLens reads and writes the workspace from your browser; there is no FuelLens sync server.

Open FuelLens

What syncs

The workspace contains serving records, daily nutrient summaries, biometrics, exercises, and selected profile settings such as goals and macros. Device-specific display and date-filter preferences stay on that device. Existing history is retained; changes are tracked record by record, including deletions.

Drive stores one compressed .flsync.gz workspace file. FuelLens checks its SHA-256 checksum when reading the file, so incomplete or damaged data is rejected instead of being applied.

Connect or create a workspace

Open Settings → Google Drive Sync and sign in when prompted.

  • Create a workspace: enter a name and choose a Google Drive folder in the Google Picker. FuelLens uploads the current data to a new workspace file in that folder.
  • Connect to a workspace: choose an existing FuelLens workspace file. FuelLens downloads it and applies its data to the current browser.

Choose the same workspace file on each device that should share data. The account needs edit access to upload changes. A workspace in a shared folder can be selected by another Google account when it has the required Drive access.

If the browser already contains data, export a backup before connecting to a workspace you have not used on this device. Connecting applies the workspace to the browser; it does not combine unrelated datasets automatically.

Automatic and manual sync

After a workspace is connected, saved FuelLens data changes are queued for background sync. Small bursts are grouped; syncing normally starts after about 15 seconds and may wait longer while more changes keep arriving. Reconnecting to the internet triggers a sync. A valid cached Google access token lets background sync run without opening a sign-in popup.

Use Sync now in the sync dialog to start a manual sync. If Google sign-in is needed again, FuelLens pauses background syncing and asks you to sign in before continuing. Sync status and errors appear in the dialog.

When the remote workspace has not changed, FuelLens checks its Drive version and skips downloading the full workspace. When another device has updated it, FuelLens downloads the latest version and merges record-level changes.

Conflicts

If the same record was changed differently on this device and in Drive, FuelLens pauses before uploading. It shows the conflicting record and asks which value to keep. For supported records, you can choose local or Drive values for individual fields; choose a value for every conflict to continue.

Until the choices are complete, neither side is overwritten. After you resolve the conflicts, FuelLens applies the merged data locally and uploads the resolved workspace.

Restore points and backups

FuelLens keeps a Drive revision before the first upload of a day and when you explicitly request a restore point. Up to 10 restore points are retained; older points are pruned when Drive permits it. Restore points are safety copies, not a substitute for a separate backup.

You can also download a full JSON backup from the sync dialog. Keep a copy somewhere safe before switching workspaces or making a large data change.

Privacy and access

FuelLens requests Google's narrow drive.file permission. The app works with the workspace files you select or create through Google Picker; it does not scan all Drive files. Workspace data is stored in your Google Drive and local browser storage, and is transferred directly between your browser and Google Drive using your Google sign-in.

Disconnecting removes this browser's FuelLens sync configuration and cached access token. It does not delete the workspace or other backup files from Google Drive. You can reconnect by selecting the workspace file again.

Troubleshooting

  • Sign-in required: reconnect your Google account in the sync dialog. Background sync stays paused until authentication succeeds.
  • No edit access: ask the workspace owner to grant edit access, then retry.
  • Workspace changed elsewhere: wait for the merge to finish or resolve the displayed conflicts.
  • Damaged or incomplete file: retry the sync on a stable connection. FuelLens validates file size and checksum before applying downloaded workspace data.
  • Workspace not listed: use the correct Google account and confirm that the account can access the selected Drive folder or shared drive.

Related guides

Continue with these connected Fuel Lens guides.