tldraw Desktop — Native Editor for .tldr Files
Why This Matters
tldraw is one of those tools that punches enormously above its weight on the web — an open-source infinite-canvas whiteboard / diagramming editor that has quietly become the default "low-fi diagram" tool for a lot of engineering teams. It's also the underlying SDK that powers an increasing share of "draw me a flowchart" AI features. The web app at tldraw.com is what most people know.The Homebrew cask is the desktop wrapper — version 1.2.3, macOS 12+ — that gives you a native app, local-file persistence (
.tldr files on disk), and offline use without paying with browser tabs. Same editor, but it now lives in your filesystem like a real document.What It Actually Does
- Local
.tldrfiles. Documents live on disk, in a version-controllable JSON-ish format, openable bytldrawon any machine. - The full tldraw editing surface. Arrows, shapes, sticky notes, freehand, embedded images, frames — all the primitives the web app has, in a native window.
- Infinite canvas. Pan, zoom, group, frame regions.
- Offline-first. No account, no sync, no cloud — just files.
- Open source. MIT-licensed engine. The desktop wrapper is a thin Electron/native shell around the same React-based editor that powers the web product.
Where It Fits in Our Workflow
tldraw slots into the "low-fi diagram you actually iterate on" niche where Excalidraw and (paid) Whimsical also live. For the Lossless tree specifically:context-v/specs/diagrams. Many of our specs need a diagram component (architecture, data flow, sequence of agent operations). Today these are usually Mermaid blocks — great for version control, terrible for spatial reasoning. A.tldrfile checked in alongside the.mdcovers the "draw it out" case Mermaid can't.- Deck iteration whiteboard. Under deck iteration workflow the early-stage version of a fundraise narrative is almost always a spatial sketch before it's slides.
.tldrfiles give you a versioned diff-able artifact that survives across deck rebuilds. - Versus Excalidraw. Excalidraw has a similar pitch (open-source, sketchy aesthetic, file-on-disk). tldraw is more polished, more shape-flexible, slightly less "intentionally rough." Both are reasonable; tldraw's strength is that it's also an SDK, so anything you learn about the file format and primitives transfers if you later embed the editor into a Lossless site.
Note that this cask is distinct from the web product. If you collaborate primarily through tldraw.com's shared boards, the desktop app is a complement, not a replacement.
Install
bash
brew install --cask tldraw