How SuperCards stores your data

SuperCards is deliberately boring under the hood — in the best way. There is no database, no server, and no account. Your entire library is a folder of ordinary files on your own disk.

Where your library lives

By default, at ~/SuperCards/Library on your Mac. With iCloud sync enabled, the library moves into your iCloud Drive so your iPhone can read it too. The Settings page always shows which location is active.

Why it matters

• Privacy — your notecards never touch our servers, because we don't have any
• Durability — plain files outlive any app: back them up with Time Machine, version them with git, or just copy the folder
• Portability — because cards are readable JSON in a documented format, other tools (including AI assistants via the SuperCards Exchange Format) can create decks that import natively

Inside a deck folder

Every deck is a folder; every card is a single, human-readable JSON file inside it. A typical deck looks like this:

              Spanish Vocabulary/
├── deck.json          # Title, summary, and deck style
├── card_order.json    # The order cards appear in
├── cards/             # One JSON file per card
└── assets/            # Images and rendered math