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, in four artifacts

Full specification

Every field, rule, and processing behavior — for implementers, toolmakers, and curious models.

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

Complete example manifests you can download, inspect, and import as-is.

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 spec and schema are versioned artifacts; their canonical source lives in the SuperCards desktop repository and is published here. Questions or edge cases? Get in touch.