Data Management / Restore, Migration & Reset
Data Management
4 min read

Restore, Migration & Reset

Import backup files on a new device, merge existing workspaces, inspect storage quotas, or perform a clean application reset.

Importing a Backup File#

To restore your data on a new device or browser:

  1. Open Settings > Data Management.
  2. Click Import Backup File.
  3. Select your mudawim_backup_*.json file.
  4. Mudawim validates the JSON structure and instantly loads your full learning environment.

Conflict Handling & Merging#

When importing a backup:

  • Mudawim checks schema versions and auto-migrates legacy structures.
  • All playlists, notes, streak dates, and coin records are validated before committing to storage.

Resetting All Application Data#

If you wish to wipe all data and start completely fresh:

  1. Go to Settings > Data Management.
  2. Scroll to Danger Zone: Reset Application.
  3. Type `DELETE` into the confirmation box.
  4. Click Reset Application. All local storage is cleared and initialized to factory defaults.