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
- Capture selectionMac clipboard helper
- Parse & normalizeBrowser worker · libfreeform
- Preview & reportEditable + unsupported items
- Export locally.excalidraw download
Explore the full architecture
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.
