Like the work? Buy me a coffee
Selected projects

Case study · Developer tool

BoardEject

Converts Apple Freeform boards into editable Excalidraw files.

Apple Freeform has no editable export. BoardEject turns a Freeform selection into editable Excalidraw, or saves a whole board as a verified local archive. Nothing gets uploaded.

Role
Solo, design to release
Stack
TypeScript, React, Rust/WebAssembly, Swift
Runs on
Any browser, plus a small Mac helper for capture
Privacy
No account, no uploads

The problem

I kept seeing the same question on Reddit from Freeform users: how do I get my board out in a form I can still edit? Freeform only exports images and PDFs. Shapes, text and arrows all get flattened.

The clipboard format is private, browsers can't read it, and the best open parser I found dropped text, connector links and tables on real boards.

What I built

You copy objects in Freeform and click import. A small Mac helper reads one clipboard snapshot, a Rust parser running in the browser decodes it, and you get a report of what converted, what's approximate and what isn't supported, before you download an editable Excalidraw file.

There's also an archive mode: pick a board, save it with all its original files into one local file, and verify it later. Archive Explorer opens that file in any browser, no Mac needed.

System design

Your board. A new format. All local

Read how it works
Walk through the system
BoardEject architectureA copied Freeform selection passes through the local Mac helper into a versioned capture. A browser worker parses it with libfreeform and normalizes it into a shared board model. The Excalidraw converter creates editable output; preview and fidelity reports expose unsupported items before download. Board data stays on the device. This map covers editable export, not the separate archive flow.
  1. Capture selectionMac clipboard helper
  2. Parse & normalizeBrowser worker · libfreeform
  3. Preview & reportEditable + unsupported items
  4. Export locally.excalidraw download
Explore the full architecture
BoardEject architectureA copied Freeform selection passes through the local Mac helper into a versioned capture. A browser worker parses it with libfreeform and normalizes it into a shared board model. The Excalidraw converter creates editable output; preview and fidelity reports expose unsupported items before download. Board data stays on the device. This map covers editable export, not the separate archive flow.

Editable-export path for the verified Freeform 4.5 subset. No board uploads.

Design notes

A local-first Freeform-to-Excalidraw pipeline: a Mac helper captures a copied selection, a browser worker parses it, and a normalized board model feeds the converter and fidelity report.

Keep boards on the device

Capture and conversion happen locally. There is no board-upload service or account requirement.

Normalize before converting

A shared board model separates Freeform decoding from Excalidraw output and preview.

Make fidelity visible

The conversion report identifies supported, partial, and unsupported items. Keep the original board; arbitrary Freeform versions are not supported.

Calls I'd make again

  • Report what can't convert. Unknown elements are listed in the report, not guessed.
  • Never touch the live database. The helper works on a read-only copy and deletes it afterwards.
  • Same board in, same bytes out. Archives are sorted and hashed, so verification means something.
  • The helper only listens on localhost, checks the page's origin, and uses a fresh token every launch.

The hard parts

  • Reverse-engineering the format one change at a time: capture a board, change one thing, capture again, compare, then lock it in with a test.
  • Arrows that stay attached to their shapes after conversion. A browser test drags a shape and checks the arrow follows.
  • Tables with uneven and empty cells, and nested groups whose positions were already in canvas space.

What's still rough

Only a verified slice of Freeform 4.5 converts. Fonts aren't exact, pressure-sensitive ink comes out at one width, and the Mac helper isn't notarised yet, so macOS asks once before opening it.

Next case studySignalizeAI