SuperCards

Version 0.3.0

Create decks from PDFs, images, and web pages with AI • Search cards in Brain Dump and Deck Library instantly • macOS Tahoe compatibility and reliability improvements

0.3.0 · macOS, iOS

New Features

SuperCards Exchange Format & LLM-Integrated Workflows (macOS)

The headline feature of v0.3.0: use your favorite AI tools (Claude, ChatGPT, Gemini) to create content-rich decks from existing material. The new import pipeline covers the full journey:

  • Exchange Format (.supercards.json): A semantic JSON schema that describes deck content declaratively — headings, body text, images — without worrying about layout
  • Prompt Templates: Built-in prompt templates for five workflows — PDF, image files, text documents, web pages, and from scratch — ready to paste into any LLM
  • Layout Engine: Automatically converts semantic content blocks into positioned card elements, handling text sizing, image placement, and multi-face layouts
  • PDF Image Extraction: Images referenced by page and index are extracted automatically during import
  • URL Image Support: Image blocks can reference URLs; the pipeline downloads and embeds them
  • Validation & Preview: A no-side-effects validation step shows warnings and a card count before committing the import
  • Two-Phase Import: ASSEMBLE to a temp directory, then DRIP-FEED to the iCloud-synced library to prevent partial sync corruption

Deck Builder (macOS)

A dedicated window for importing AI-generated decks:

  • Select an import folder containing a .supercards.json manifest and any referenced assets
  • Preview validation results (card count, warnings, errors) before importing
  • One-click import creates the deck and updates the library index

Workflow Instructions Modal (macOS)

A 4-step guided tutorial accessible from the Home screen:

  • Step-by-step instructions: how it works, copy prompt, upload & describe, import
  • LLM selector (Claude, ChatGPT, Gemini) with tailored prompt preview
  • Copy-to-clipboard for immediate use in your AI assistant

Search in Brain Dump & Deck Library (macOS)

  • Search fields in Brain Dump and Deck Library for quickly finding cards
  • Card-level queries filter results as you type
  • Select a card from search results to load it directly into the Card Editor

Deck Picker Modal (macOS)

  • New modal when launching the Card Editor lets you choose which deck to edit
  • “Load from last modified” option for quick access to your most recent work

Improvements

Home Screen (macOS)

  • Redesigned bento grid layout with compact changelog highlights and expanded workflow section
  • New “LLM-Integrated Workflows” section with five entry points for AI-assisted deck creation
  • Updated navbar icon to monochrome stroke design
  • New orange beta badge

Card Editor (macOS)

  • Dynamic window titles show the current deck and card name
  • Image processing preserves original format instead of re-encoding to PNG
  • Skips unnecessary decode/encode round-trip when no resize is needed

macOS Tahoe Compatibility

  • Liquid Glass visual effects suppressed to preserve the intended app appearance
  • NSPopover calls dispatched to main thread to prevent crashes on Tahoe
  • Dropdown Tile redesigned for Tahoe compatibility
  • Tray icon embedded into the binary at compile time for reliable display

Architecture

  • Extracted Tauri commands from monolithic lib.rs into dedicated files under src-tauri/src/commands/ (import, deck, window commands)
  • Removed deprecated hooks and legacy components
  • Reorganized Card Editor and Brain Dump windows into feature folders

Bug Fixes

  • Fixed Deck Builder form state not resetting between sessions
  • Fixed interleaved section detection in the layout engine for common content patterns
  • Fixed image filename matching with fuzzy resolution for AI-generated references
  • Fixed tray icon not displaying when launched from certain working directories
  • Fixed DMG background graphics for compatibility with both Light Mode and Dark Mode

Technical Updates

  • New Rust modules: import_models.rs, import_validator.rs, import_pipeline.rs, layout_engine.rs, pdf_extractor.rs
  • Added source field to Deck models for tracking import provenance
  • Text sanitization in the import validator strips unsafe content from AI-generated manifests
  • Updated version bump script to account for refactored command files
  • New changelog generation scripts for both expanded and compact Home screen variants

What’s Next?

We’re working on version 0.3.1, which will introduce:

  • Rich Text Editing: Format text directly on cards with bold, italic, and more
  • Scrollable Card Navigation: Browse through cards without leaving the editor

See our full roadmap for upcoming features.

Feedback

Found a bug or have a feature request? We’d love to hear from you:

Thank you for using SuperCards!