Moving to a new phone

A new or reinstalled phone on the same platform restores your log on its own, as long as the automatic backup was on beforehand. Moving between an iPhone and an Android phone takes one deliberate step, since each platform's automatic backup stays on that platform.

New or reinstalled iPhone

If iCloud backup was on before, Badger finds your log on its own. The first time it opens on the new or reinstalled phone, it checks your iCloud for a backup - a brief moment, a spinner only if it takes more than a beat.

Find one with workouts in it, and Badger offers Restore my log. You can also Start fresh or Choose another copy from the full list. Restoring replaces onboarding, so you land straight in your history.

If the check is still running when onboarding reaches the Backup page, the offer appears there instead. If iCloud backup was off, there is nothing to find - use Google Drive or a backup file below.

New or reinstalled Android phone

Badger keeps five dated copies of your log on the phone itself. If your phone's own backup was turned on beforehand (Settings → System → Backup, the exact path varies by phone maker), Android carries those copies to your Google account and restores them the moment the new or reinstalled phone opens Badger.

If that setting was off, there is nothing for Android to have carried over - use Google Drive or a backup file below.

Moving between iPhone and Android

iCloud and Android's own backup are each locked to their own platform, so crossing from one to the other needs Google Drive backup or a manual file - both work the same way on either phone.

Google Drive backup

1. On the old phone, go to You → Settings → Your data → Backup and turn on Google Drive backup, signing in with your Google account. Badger takes the first backup straight away, and then after every workout and once a day when something has changed.
2. Install Badger on the new phone and turn on Google Drive backup there too, with the same Google account.
3. On the Backup screen's Restore a copy list, tap the Drive copy you want. Badger confirms, then restarts with your history in place.

A backup file

A .workout_backup file contains your full local database:

• Every workout and set, with warmups, comments, RPE and RIR.
• Your exercise library, including custom exercises and categories.
• All routines, days and planned sets.
• Body measurements and body-weight history.
• Gyms, machines, attachments, bars, accessories and their links to exercises, plus each gym's plates and racks.
• Your settings (accent color, weight unit, theme, notifications) and your training notes.

App settings (accent color, weight unit, theme, notification preferences), your training notes, and each gym's plates and racks ride along in the backup too. Photos you added to machines, attachments or bars are included only when Back up equipment photos is turned on - see the Backup screen.

Step 1 - Back up on the old phone

1. Go to You → Settings → Your data.
2. Tap Manual backup. The system share sheet opens.
3. Save the .workout_backup file somewhere you'll be able to reach from the new phone - Google Drive, email-to-self, WhatsApp, a USB transfer, or your preferred cloud storage app.

Do this after your last workout on the old phone. Anything you log after taking the backup will not be carried over.

Step 2 - Install Badger on the new phone

1. Install Badger from the App Store or Google Play, whichever the new phone uses.
2. Go through the short onboarding (weight unit, import options). On the import page, tap Not now, I'll import later, since you'll restore instead.

Step 3 - Restore the backup

1. Make sure the backup file from Step 1 is reachable on the new phone (saved in Files, Drive, or attached to an email you've opened).
2. Open Badger → You → Settings → Your data → Backup.
3. Under Extra, tap From a file….
4. Pick the .workout_backup file. Badger will confirm - tap Restore.
5. The app replaces its current database with the one from the backup and restarts. When it comes back up, all of your history is there.

Moving from TestFlight to the App Store

If iCloud backup is on and current, the App Store version restores your log automatically on first launch - see New or reinstalled iPhone above. Back up manually first if you want to be certain, or if iCloud backup is off.

1. In the TestFlight version, make sure iCloud backup is on (Settings → Backup), or take a manual backup and save the file somewhere outside Badger.
2. Delete the TestFlight version of Badger. The App Store will not install over it, so you have to delete it first, and deleting it deletes the app's local data.
3. Install Badger from the App Store.
4. If iCloud backup was on, Badger offers to restore your log on first launch. Otherwise, follow Step 3 above with your manual backup file.

Troubleshooting

• The picker doesn't see my file. Move the backup into your phone's main Downloads or Documents folder, or open it directly from your cloud app's share sheet ("Open with Badger").
• Restore fails with a format error. The file may have been truncated during transfer - re-export on the old phone and move it again via a different channel.
• New iPhone didn't offer to restore. iCloud backup may have been off on the old phone, or the check may not have found a copy yet - open You → Settings → Your data → Backup and check Restore a copy directly.
• New Android phone didn't restore automatically. Your old phone's system backup setting was probably off - check Settings → System → Backup on the old phone for next time, and restore this once from a Google Drive backup or a saved file.
• Old phone is dead, no manual backup. If Google Drive backup was on, sign in with the same Google account on the new phone under Settings → Your data → Backup and restore from there. If it was off and no backup file exists, the data cannot be recovered.