Backup & JSON Export

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, study streaks, coins, and course progress are permanently preserved.

Full Gamification & Coin State Portability#

Mudawim exports your complete gamification state in every backup snapshot:

• Streak Coin Balance & Lifetime Earnings
• Complete Transaction Ledger: Full audit history of earned coins, streak repairs, and freeze token purchases.
• Active Freeze Tokens: Your available streak freeze inventory.
• Claimed Achievements: Profile creation milestones, course additions, and workspace setup badges.
• Redeemed Coupons: Coupon history and monthly claim trackers.

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, digitally signed JSON file (e.g., mudawim_backup_2026-09-17.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, achievements, and transaction history.
• integritySignature: Cryptographic SHA-256 HMAC digital signature verifying file integrity.