Mudawim Logo
Mudawimمُدَوِّم
Data Management / Backup & JSON Export
Data Management
4 min read

Backup & JSON Export

Generate complete, human-readable JSON backup files of all your workspaces, courses, progress timestamps, and notes.

Why Backups Matter in Local-First Apps#

Because Mudawim stores your database locally inside your browser, clearing your browser cache or switching to a new laptop requires moving your local database.

Creating regular JSON backups ensures your notes, streaks, and course progress are permanently preserved.

How to Download a Full Backup Snapshot#

  1. Open Settings from the sidebar.
  2. Scroll to the Data Management & Backup section.
  3. Click Export Complete Backup (.json).
  4. A timestamped JSON file (e.g., mudawim_backup_2026-09-07.json) will download to your computer.

Understanding the JSON Schema#

The backup file is a clean, formatted JSON document containing:

  • version: Database schema version.
  • profile: User profile information and study intent.
  • workspaces: Array of workspaces, color accents, and playlist associations.
  • playlists: All course playlists, video IDs, and custom ordering.
  • videoMetadata: Cached video titles, durations, and thumbnails.
  • progress: Watched seconds, completion flags, and last-watched timestamps.
  • pinnedNotes: All timestamped notes with markdown text and tags.
  • streaks: Consecutive streak counts, study dates, and weekly activity logs.
  • streakCoins: Coin balance, freezes, and transaction history.
Previous
Coupons & Emergency Coin AidRedeem promotional voucher codes or submit an emergency coin grant request through the contact form during special circumstances.
Next
Restore, Migration & ResetImport backup files on a new device, merge existing workspaces, inspect storage quotas, or perform a clean application reset.