SuperCards

SuperCards Exchange Format

SEF is a documented JSON format for generating complete SuperCards decks — content, layout, images and all. Ask an AI assistant for one (or write the file yourself), then import it with a drag or a double-click. It lands as a native deck: editable on your Mac, ready to study on your iPhone.

Format version 1.1.0 · plain JSON, human-readable · the same format powers deck sharing (.supercards archives)

Using Claude? Skip the manual steps

The SuperCards connector gives Claude Desktop and claude.ai a direct line to the app: Claude drafts the deck, checks it against the format, and hands it over — you get a validated preview and one-click import.

Set up the connector

Using another model? The universal prompt works with any LLM that can read a link — it produces a file you drag onto the app.

The format's artifacts

llms.txt

The model-optimized reference. Hand it to an AI along with your source material and ask for a deck.

JSON Schema

Machine-readable and authoring-strict (draft 2020-12), served CORS-open for validators and editors.

Examples

A complete example manifest you can download, inspect, and import as-is.

Full specification

Being finalized. Every field, rule, and processing behavior will be published here soon.

The minimal valid file

A deck title plus one card with one text block — everything else is optional. Text is markdown by default. 

{
  "supercards_format": "1.1.0",
  "deck": { "title": "My Deck" },
  "cards": [{ "front": [{ "type": "text", "text": "Hello, world!" }] }]
}

Save it as anything.supercards.json, drag it onto SuperCards, and it imports as a one-card deck.

How an AI-generated deck reaches your phone

  1. 1. Generate. Point any model at the reference along with your source material — lecture notes, a PDF, a codebase.
  2. 2. Import. Drag the resulting file onto SuperCards, or double-click a .supercards archive. You review a validated preview before anything is saved.
  3. 3. Study. The imported deck is fully native — edit it in the Card Editor, and it syncs to the iOS app through your iCloud.

The reference and schema are versioned artifacts, published here for the format version the current apps import. Questions or edge cases? Get in touch.