ContextQMD
Back to Tldraw

Releases

apps/docs/content/getting-started/releases.mdx

5.0.13.8 KB
Original Source

Release notes for all tldraw SDK versions. Each minor release has its own page documenting new features, breaking changes, API additions, improvements, and bug fixes. Patch releases are listed within their parent minor release.

For the original releases, see the GitHub releases page.

How tldraw is versioned

Unlike many JavaScript packages distributed on NPM, the tldraw SDK does not follow semantic versioning in its release versions. Instead:

  • Major version bumps are rare. We reserve them for fundamental changes to how the SDK works.
  • 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 at a similar pace and checking the release notes.
  • Patch version bumps are for bugfixes and hotfixes that can't wait for the next cadence release.

Latest tldraw versions

  • Run npm install tldraw to get the latest minor version of tldraw
  • Use npm install tldraw@next to get the latest version of tldraw that is used on tldraw.com
  • The latest changes to the main branch of tldraw are available to test through our pre-release canary builds.

Migration skill

We ship an experimental tldraw-migrate agent skill to let an agent help you update to the latest version of the sdk. It detects your current version, fetches the relevant release notes, upgrades packages, and works through any type errors using the migration guides in our release notes. See our migration skill guide for details on how to set up and use the skill.

Next

  • next - Changes for the upcoming release.

v5.x

  • v5.0 - Custom themes, overlays, performance, extensiblity, and attribution

v4.x

  • v4.5 - Click-through on transparent pixels, SVG sanitization, configurable embed definitions
  • v4.4 - Image pipeline starter kit, performance improvements, quick zoom, canvas indicators
  • v4.3 - SQLite sync storage, improved custom shape types, reactive inputs, draw shape encoding
  • v4.2 - TipTap v3, dynamic tools, custom socket implementations
  • v4.1 - Shader starter kit, localStorage atoms, minimap filtering
  • v4.0 - Starter kits, WCAG 2.2 AA compliance, licensing updates

v3.x

  • v3.15 - npm create tldraw CLI, accessibility improvements
  • v3.14 - Contextual toolbars, PathBuilder API
  • v3.13 - Elbow arrows for technical diagrams
  • v3.12 - Accessibility focus, keyboard navigation
  • v3.11 - Rich text fixes, zoom improvements
  • v3.10 - Rich text as first-class primitive
  • v3.9 - Layout improvements, AtomMap class
  • v3.8 - React 19 compatibility, i18n expansion
  • v3.7 - Presence sync customization
  • v3.6 - Expanded action helpers
  • v3.5 - Grid snapping, layer improvements
  • v3.4 - Excalidraw compatibility
  • v3.3 - Readonly mode, sync improvements
  • v3.2 - Version alignment release
  • v3.1 - Shape visibility, server-side updates
  • v3.0 - New licensing, deep links, custom embeds

v2.x