v4.1.0 • tldraw Docs

This month's release introduces a new shader starter kit for WebGL integration, along with API additions for embed control, minimap filtering, and localStorage-backed atoms.

What's new

Shader starter kit (#6847)

A new template demonstrating WebGL shader integration with tldraw for dynamic, interactive backgrounds that respond to canvas interactions. Includes four complete examples:

Fluid simulation - Navier-Stokes dynamics
Rainbow - Animated gradients
Shadows - Raymarching and signed distance fields
Minimal - Bare-bones template for custom shaders

Features configurable parameters, localStorage persistence, and full TypeScript support.

API changes

Add embedOnPaste option to EmbedDefinition for opting out of automatic embed-on-paste behavior. (#6874)
Add hideInMinimap option to ShapeUtil for excluding shapes from the minimap. (#6327)
Add snapType?: 'point' | 'align' to TLHandle for finer control over handle snapping. The canSnap property is now deprecated. (#6883)
Expose Editor#getShapePageBounds and isRecordsDiffEmpty as public methods. (#6871)
Add localStorageAtom to @tldraw/state for atoms backed by localStorage with cross-tab syncing. (#6876)
Add inline style picker component variants. (#6920)

Improvements

Make bookmark titles clickable. (#6326)
Optimize mobile top bar rendering. (#6895)
Add numpad Enter support for entering edit mode. (#6830)
Consolidate preferences menu items. (#6802)

Bug fixes

Fix accessibility shortcut typo. (#6811)
Fix focus mode action missing. (#6812)
Fix arrow rendering edge case. (#6799)
Fix empty window opening on anchor click. (#6817)
Fix missing translation key. (#6826)
Fix shape index race condition. (#6884)
Fix zero geometry vertices edge case. (#6885)
Fix style panel button overflow. (#6920)

View release on GitHub

Patch releases

v4.1.1

Update the formatting of the npm create tldraw command in the CLI output.

View release on GitHub

v4.1.2

Move InFrontOfTheCanvas component back out of the .tl-canvas element. (#7021)

View release on GitHub