Releases

How tldraw is versioned

Unlike many JavaScript packages distributed on NPM, the tldraw SDK does not follow semantic versioning in its release versions. Here's what we do instead:

Major version bumps are very rare and we reserve them for special changes that signify a paradigm shift of some kind.
Minor version bumps are released on a regular cadence - approximately monthly. They may contain breaking changes. We aim to make breaking changes as minimally disruptive as possible, but tldraw is actively evolving as we add new features. We recommend updating tldraw at a similar pace to our release cadence, and be sure to check the release notes.
Patch version bumps are for bugfixes and hotfixes that can't wait for the next cadence release.

Current release: v4.2.0

Welcome to tldraw v4.2.0!

This is a minor maintenance release that includes many bug fixes and small API additions, along with a major version bump of our TipTap rich text editor.

TipTap v3 (#5717)

We've upgraded TipTap from v2 to v3. If you've done any customization to our standard TipTap kit, please refer to TipTap's Guide How to upgrade Tiptap v2 to v3 as to any breaking changes you might experience from a custom homebrew of the rich text editor in tldraw.

API Changes

Add Editor.setTool/Editor.removeTool for dynamically altering the editor's tool state chart. (#6909) (#7134)
Allow using custom socket implementations with useSync via a new connect option (#6859) (thanks to @Digital39999 for help on this one)
Support store queries on nested properties, e.g. props (#6981)
Add createBookmarkFromUrl helper function for creating bookmark shapes more easily. (#6894)
Allow handles to specify a custom reference point for shift-modifier angle snapping (#6987) (contributed by @naaa760)
Add a 'secret' lined-fill style similar to the full-fill style but with visible outlines. Users can select it by pressing Option+Shift+F. (#7034)
Add option to pass callback to onInteractionEnd (#6919)
Add allowReferrer option to window opening functions (#7004)
Remove broken/defunct Excalidraw embed definition. Existing Excalidraw embed shapes will remain but render as bookmarks. (#6897)

Improvements

Use window.prompt for renaming frames on mobile (#6838)
Add string append optimization to sync protocol (#7007) (contributed by @quasor)

Bug Fixes