Release Notes

Fix camera. (#2818)

• Fixes an issue with the camera and zooming.

Use canvas bounds for viewport bounds (#2798)

• Changes the source of truth for the viewport page bounds to be the canvas instead.

docs: better code snippets (#2801)

• Docs: reworks code snippets

Quick start guide (#2692)

• Add a quick start guide

docs: fix scrolling issue with sidebar (#2791)

• Docs: fix up scrolling.

Style UI based on component size instead of window size (#2758)

• Dev: Fixed the default tldraw UI not matching the size of the component.

examples: clean up Canvas/Store events and make UiEvents have code snippets (#2770)

• Examples: add an interactive example that shows code snippets for the SDK.

Fixed actions menu opening in wrong direction on mobile (and add an inline layout example) (#2730)

• Dev: Fixed the actions menu opening in the wrong direction.

error reporting: rm ids from msgs for better Sentry grouping (#2738)

• Error reporting: improve grouping for Sentry.

rearrange export / import from tldraw to help builds (#2739)

• Build: Help with import/export error on some builds.

i18n: add HR 🇭🇷 (#2778)

• i18n: add Croatian / Hrvatski.

arrows: account for another NaN (#2753)

• Fixes zero-width arrow NaN computation when moving the label.

Split snap manager into ShapeBoundsSnaps and HandleSnaps (#2747)

• SnapLines are now called SnapIndicators
• Snapping methods moved from editor.snaps to editor.snaps.shapeBounds and editor.snaps.handles depending on the type of snapping you're trying to do.

arrows: update cursor only when in Select mode (#2742)

• Cursor tweak for arrow labels.

Fix pinch zooming (#2748)

• None: Fixes an unreleased bug.

docs: disable ai search for now (#2740)

• Docs: disable AI search for now.

seo: attempt at avoiding a "soft 404" with there being thin content on dotcom (#2737)

• Add a "Loading..." text to help SEO.

docs: add full-text search (#2735)

• Docs: Add full-text search.

docs: fix CORS issue and broken example link (#2727)

• Fixes docs CORS issue.

docs: rework search UI (#2723)

• Docs: rework the search to be an inline dropdown.

[fix] VSCode keyboard shortcuts while editing text (#2721)

• Fixed a bug in the VS Code that prevented keyboard shortcuts from working in text labels.

[Fix] Camera coordinate issues (#2719)

• Fixed bugs with getViewportScreenCenter that could effect zooming and pinching on editors that aren't full screen

fix(docs): fix user-interface.mdx (#2700)

Add newMenuItem creation in "Toolbar and Menus" example

docs: more cleanup following restructure (#2702)

• Docs: further cleanup following restructure.

reactive context menu overrides (#2697)

• Context Menu overrides will now update reactively

[Fix] Note shape border radius (#2696)

• Fixes a bad border radius

arrows: separate out handle behavior from labels (#2621)

• Arrow labels: provide more polish on label placement

docs: fix up gen links to point to the new /reference section (#2690)

• Fix up doc links with /gen links

docs: rework docs site to have different sections (#2686)

• Rework our docs site to pull together the examples app and reference section more cohesively.

Fix svg exporting for images with not fully qualified url (/tldraw.png or ./tldraw.png) (#2676)

• Fix the svg export for images that have a local url.

Remove examples app landing page (#2678)

• Remove examples app landing page

dev: add test-dev command for easier testing of packages (#2627)

• Adds easier testing command for individual packages.

debug: start adding more tooling for debugging when interacting with shapes (#2560)

• Adds more information in the debug view about what shape is selected and coordinates.

Grouping examples into categories (#2585)

• Add collapsible categories to the examples app

[Fix] Overlapping non-adjacent handles (#2663)

• Fixed a bug with virtual / create handle visibility.

[Fix] Missing bend handles on curved arrows (#2661)

• Fixed a bug where the bend handle on arrows with a large curve could sometimes be hidden.

Improved duplication (#2480)

• Add a brief release note for your PR here.

Positional keyboard shortcuts for toolbar (#2409)

• You can now use the number keys to select the corresponding tool from the toolbar

Add button to Examples to request an example (#2597)

• Add a button to request an example to the examples app

Update README and examples copy in the docs (#2594)

• Update examples copy and tldraw README

Remove repeated word in CONTRIBUTING.md (#2651)

• Remove repeated word in CONTRIBUTING.md.

[Fix] Wheel bug (#2657)

• Fixed a bug with the mouse wheel effecting the pointer location when the editor was not full screen

Update layout.tsx (#2619)

• Add a brief release note for your PR here.

[Improvement] Share zone styling (#2628)

• Tweaked user avatar size.

[draft] Keep editor focus after losing focus of an action button (#2630)

• Fixed a bug where keyboard shortcuts could stop working after using an action button.

Fix nudge bug (#2634)

• Fixes a bug with keyboard nudging.

menus: address several little big things about menu styling (#2624)

• Fixes nits on styling on our Radix menus.

i18n: sort languages by name, not by locale code (#2625)

• Sorts the locale list by locale name, not code.

style: fix missing titles on vertical align menu (#2623)

• Adds missing titles to vertical align menu.

Only actions on selected shapes if we are in select tool. (#2617)

• Disable actions that work on selections when we are not in select tool as it makes it not obvious what the target for these actions.

debug: add FPS counter (#2558)

• Adds FPS counter to debug panel.

Fix ios export crash (#2615)

• iOS Safari: Fixed a crash when exporting large images.

arrows: add ability to change label placement (#2557)

• Adds ability to change label position on arrows.

Add context toolbar example. (#2596)

• Add context toolbar example.

Export TLCommandHistoryOptions type (#2598)

• Added TLCommandHistoryOptions to the exported types.

[improvement] better comma control for pointer (#2568)

• Improve comma key as a replacement for pointer down / pointer up.

fix: replaced dead links (#2567)

• N/A

[dotcom] Delete service worker, cache tldraw assets (#2552)

• Fix 'could not load assets' error that we often see on tldraw.com after a deploy

Allow snapping of shapes to the frame when dragging inside the frame. (#2520)

• Adds snapping to frames when dragging shapes inside a frame.

Allow dismissing dialogs by clicking backdrop (#2497)

• Allows dismissing dialogs by clicking the backdrop.

Fix the first run of dev script. (#2484)

• Fix first yarn dev experience.

Prevent overlay content disappearing at some browser zoom levels (#2483)

• removes the internal useDprMultiple hook

add keyboard shortcuts example (#2474)

• Add keyboard shortcuts example

[hot take] Make dark mode colours pop more (#2478)

• Tweaked dark mode colour styles to make them pop more.

fix typo in hideRotateHandle method (#2473)

• fix typo in hideRotateHandle method

Maintain bindings whilst translating arrows (#2424)

• You can now move arrows without them becoming unattached the shapes they're pointing to

[improvement] update dark mode (#2468)

• Updated dark mode colors.

rename and annotate user presence example (#2462)

• annotate user presence example and rename to presence-record

annotate onthecanvas example (#2459)

• annotate onthecanvas example

annotate snapshot example (#2454)

• annotate snapshot example

Fix and annotate minimal example (#2448)

• Fix and annotate minimal example

annotate zones example (#2461)

• annotate zones example

annotate ui events example (#2460)

• annotate ui events example

Annotate shape meta data example (#2453)

• Annotate shape meta data example

Annotate example for using Tldraw component in a scrollable container (#2452)

• Annotate example for using Tldraw component in a scrollable container

Annotate example for making editor read-only (#2451)

• Annotate example for making editor read-only

Fix typos and add comments for persistence example (#2450)

• Fix typos and add comments for persistence example

Fix bookmark info for VS Code (#2449)

• Fix bookmark image and description for VS code extension.

[fix] disable vertical edge resizing for text on mobile (#2456)

• Add a brief release note for your PR here.

Don't bother measuring canvas max size for small images (#2442)

• Android: Sped up exporting and importing images.

[Minor] change Simplified Chinese label to Chinese (#2434)

• Changed the label for the Simplified Chinese language from Chinese - Simplified to 简体中文, following the convention of other languages.
• Updated the API and relevant documentation through build scripts.

annotate external sources example (#2414)

• Adds annotation to the external sources example.

annotate multiple example (#2431)

• annotate multiple example

annotate force mobile example (#2421)

• annotate force mobile example

annotate hosted images example (#2422)

• annotate hosted images example

annotate local images example (#2423)

• annotate local images example

Lokalise: Translations update (#2418)

• Added Hungarian translations.
• Updated Turkish translations.

annotate meta oncreate example (#2426)

• annotate meta oncreate example

Annotate exploded example (#2413)

• Adds annotation to exploded example
• imports all default components instead of just a few

annotate hide-ui example (#2420)

• Annotate hide ui example

Annotate custom ui example (#2408)

• Adds annotation to the custom ui example

[improvement] account for coarse pointers / insets in edge scrolling (#2401)

• Add instanceState.insets to track which edges of the component are inset from the edges of the document body.
• Improve behavior around edge scrolling

Custom components annotation (#2403)

• Annotate the custom components example.

annotate meta onchange (#2430)

• annotate meta onchange

---

💥 Breaking Change

• @tldraw/editor, @tldraw/tldraw
  • Use canvas bounds for viewport bounds #2798 (@steveruizok)
  • Remove Geometry2d.isSnappable #2768 (@SomeHats)
  • [Fix] Camera coordinate issues #2719 (@steveruizok)
• @tldraw/editor, @tldraw/tldraw, @tldraw/utils
  • Split snap manager into ShapeBoundsSnaps and HandleSnaps #2747 (@SomeHats)
• @tldraw/tldraw, @tldraw/utils
  • faster image processing in default asset handler #2441 (@SomeHats)

🚀 Enhancement

• docs: rework search UI #2723 (@mimecuvalo)
• @tldraw/editor, @tldraw/state, @tldraw/store, @tldraw/tldraw, @tldraw/tlschema, @tldraw/utils, @tldraw/validate
  • [dx] use Biome instead of Prettier, part 2 #2731 (@si14)
• @tldraw/assets, @tldraw/tlschema
  • [dx] use Biome instead of Prettier, part 1 #2729 (@si14)
• @tldraw/tldraw
  • debug: start adding more tooling for debugging when interacting with shapes #2560 (@mimecuvalo)
  • Positional keyboard shortcuts for toolbar #2409 (@SomeHats @steveruizok)
• @tldraw/tldraw, @tldraw/tlschema
  • Improved duplication #2480 (@Taha-Hassan-Git @MitjaBezensek @ds300 @steveruizok)
• @tldraw/editor, @tldraw/tldraw
  • debug: add FPS counter #2558 (@mimecuvalo @steveruizok)
  • [improvement] better comma control for pointer #2568 (@steveruizok)
  • Allow snapping of shapes to the frame when dragging inside the frame. #2520 (@MitjaBezensek)
  • Maintain bindings whilst translating arrows #2424 (@SomeHats @steveruizok)
  • [improvement] update dark mode #2468 (@steveruizok)
• @tldraw/editor, @tldraw/tldraw, @tldraw/tlschema
  • arrows: add ability to change label placement #2557 (@mimecuvalo @steveruizok @SomeHats)
  • [improvement] account for coarse pointers / insets in edge scrolling #2401 (@steveruizok)
• @tldraw/assets
  • [dotcom] Delete service worker, cache tldraw assets #2552 (@ds300)

🐛 Bug Fix

• VS Code 2.0.24 #2816 (@MitjaBezensek)
• menu: just have an empty space for checked menuitems #2785 (@mimecuvalo)
• VS Code 2.0.23 #2756 (@MitjaBezensek)
• seo: attempt at avoiding a "soft 404" with there being thin content on dotcom #2737 (@mimecuvalo)
• docs: add full-text search #2735 (@mimecuvalo)
• docs: fix up gen links to point to the new /reference section #2690 (@mimecuvalo)
• [DX] Use tabs in JSON.stringify #2674 (@steveruizok)
• [Improvement] Share zone styling #2628 (@mimecuvalo @steveruizok)
• VS Code 2.0.22 #2500 (@MitjaBezensek)
• fix geo cloud icon #2485 (@ds300)
• Update README.md #2464 (@steveruizok)
• Fix bookmark info for VS Code #2449 (@MitjaBezensek)
• Fix the publish script #2440 (@MitjaBezensek)
• Lokalise: Translations update #2418 (@TodePond)
• VS Code 2.0.21 #2438 (@MitjaBezensek)
• @tldraw/editor
  • Fix camera. #2818 (@MitjaBezensek)
  • [fix] overlays, custom brush example #2806 (@steveruizok)
  • Fix pinch zooming #2748 (@TodePond)
  • [Improvement] Text measurement tweaks #2670 (@steveruizok)
  • [Fix] Missing bend handles on curved arrows #2661 (@steveruizok)
  • [Fix] Wheel bug #2657 (@steveruizok)
  • Export TLCommandHistoryOptions type #2598 (@steveruizok)
  • Prevent overlay content disappearing at some browser zoom levels #2483 (@ds300)
• @tldraw/tldraw
  • Style UI based on component size instead of window size #2758 (@TodePond)
  • Fixed actions menu opening in wrong direction on mobile (and add an inline layout example) #2730 (@TodePond)
  • rearrange export / import from tldraw to help builds #2739 (@mimecuvalo)
  • Fix infinite cursor chat issue by partially reverting "reactive context menu overrides (#2697)" #2775 (@SomeHats)
  • [fix] VSCode keyboard shortcuts while editing text #2721 (@steveruizok)
  • [fix] Debug panel text overflow #2715 (@steveruizok)
  • reactive context menu overrides #2697 (@SomeHats)
  • [Fix] Note shape border radius #2696 (@steveruizok)
  • Fix svg exporting for images with not fully qualified url (/tldraw.png or ./tldraw.png) #2676 (@MitjaBezensek @steveruizok)
  • [draft] Keep editor focus after losing focus of an action button #2630 (@TodePond)
  • menus: address several little big things about menu styling #2624 (@mimecuvalo)
  • style: fix missing titles on vertical align menu #2623 (@mimecuvalo)
  • Only actions on selected shapes if we are in select tool. #2617 (@MitjaBezensek)
  • Fix ios export crash #2615 (@TodePond)
  • Allow dismissing dialogs by clicking backdrop #2497 (@ds300)
  • Fix the first run of dev script. #2484 (@MitjaBezensek)
  • Don't bother measuring canvas max size for small images #2442 (@TodePond)
  • Fix main. #2439 (@MitjaBezensek)
• @tldraw/editor, @tldraw/tldraw, @tldraw/validate
  • error reporting: rm ids from msgs for better Sentry grouping #2738 (@mimecuvalo)
• @tldraw/assets, @tldraw/editor, @tldraw/tlschema
  • i18n: add HR 🇭🇷 #2778 (@mimecuvalo)
• @tldraw/editor, @tldraw/tldraw
  • arrows: account for another NaN #2753 (@mimecuvalo)
  • arrows: update cursor only when in Select mode #2742 (@mimecuvalo)
  • [Fix] Overlapping non-adjacent handles #2663 (@steveruizok)
  • Fix nudge bug #2634 (@steveruizok)
  • [tweak] dark mode colors #2469 (@steveruizok)
• @tldraw/editor, @tldraw/tldraw, @tldraw/tlschema
  • arrows: separate out handle behavior from labels #2621 (@mimecuvalo @steveruizok)
• @tldraw/tlschema
  • i18n: sort languages by name, not by locale code #2625 (@mimecuvalo)
  • [hot take] Make dark mode colours pop more #2478 (@TodePond @huppy-bot[bot])
  • [Minor] change Simplified Chinese label to Chinese #2434 (@peilingjiang)
• @tldraw/editor, @tldraw/tlschema
  • Make sure correct dark mode colours get used in exports #2492 (@SomeHats @huppy-bot[bot])
• @tldraw/validate
  • Fix validation for local files. #2447 (@MitjaBezensek)
• @tldraw/tldraw, @tldraw/tlschema
  • [fix] disable vertical edge resizing for text on mobile #2456 (@mimecuvalo)

🏠 Internal

• hello@tldraw.com -> sales@tldraw.com #2774 (@steveruizok)
• fix(infra): Fix routing config #2741 (@ds300)
• [dotcom] TLSyncRoom tidy #2712 (@steveruizok)
• [dx] add gen docs to gitignore #2704 (@steveruizok)
• return 404 on missing docs content instead of 500 #2699 (@si14)
• fix prune preview deployment script #2698 (@SomeHats)
• fix sub-project vercel configs #2687 (@si14)
• remove dotcom's vercel.json #2689 (@si14)
• check for duplicate dependencies in CI #2682 (@si14)
• Introduce a Cloudflare health worker #2499 (@si14 @steveruizok)
• [dx] Add docs to lazy caching. #2672 (@steveruizok)
• Restore vercel.jsons #2650 (@steveruizok)
• remove erroneous mount entry from fly.toml #2644 (@si14)
• make Huppy deployable (again) #2632 (@si14)
• Fix yarn clean #2620 (@si14)
• Replace "original tldraw issue" with docs link. #2599 (@steveruizok)
• [Internal] Create build-docs.sh #2569 (@steveruizok)
• add dev / build scripts #2551 (@steveruizok)
• auto-it/typescript fails the release, patch the problem away while mods are asleep #2498 (@si14)
• use github.ref rather than github.event.ref in deploy.yml #2495 (@SomeHats)
• add bash scripts for Vercel #2494 (@si14)
• @tldraw/tldraw
  • examples: clean up Canvas/Store events and make UiEvents have code snippets #2770 (@mimecuvalo)
  • delete unused duplicated DraggingHandle.ts #2463 (@ds300)
• @tldraw/assets, @tldraw/editor, @tldraw/state, @tldraw/store, @tldraw/tldraw, @tldraw/tlschema, @tldraw/utils, @tldraw/validate
  • Unbiome #2776 (@si14)
• @tldraw/editor, @tldraw/state, @tldraw/store, @tldraw/tldraw, @tldraw/tlschema, @tldraw/validate
  • Update the project to Node 20 #2691 (@si14)
  • Add docs #2470 (@steveruizok)
• @tldraw/assets, @tldraw/store, @tldraw/tlschema
  • make CI check for yarn install warnings and fix the peer deps ones we have #2683 (@si14)
• @tldraw/editor, @tldraw/state, @tldraw/store, @tldraw/tldraw, @tldraw/tlschema, @tldraw/utils, @tldraw/validate
  • dev: add test-dev command for easier testing of packages #2627 (@mimecuvalo)
• @tldraw/state, @tldraw/store
  • unbrivate, dot com in #2475 (@steveruizok @si14 @SomeHats)

📝 Documentation

• [docs] Small style changes #2805 (@steveruizok)
• docs: better code snippets #2801 (@mimecuvalo)
• Quick start guide #2692 (@Taha-Hassan-Git @mimecuvalo)
• docs: rm ... from some examples and fix up inset example #2788 (@mimecuvalo)
• docs: fix scrolling issue with sidebar #2791 (@mimecuvalo)
• docs: disable ai search for now #2740 (@mimecuvalo)
• [docs] Autocomplete styling tweaks #2732 (@steveruizok)
• docs: fix CORS issue and broken example link #2727 (@mimecuvalo)
• [docs] Fix links, little style tweaks #2724 (@steveruizok @mimecuvalo)
• [Docs] Tweak sidebar titles #2706 (@steveruizok)
• fix(docs): fix user-interface.mdx #2700 (@Rokixy @steveruizok)
• docs: more cleanup following restructure #2702 (@mimecuvalo)
• [Examples] Add a stupid 404 page #2694 (@steveruizok)
• docs: rework docs site to have different sections #2686 (@Taha-Hassan-Git @steveruizok @MitjaBezensek @mimecuvalo @TodePond @si14)
• Remove examples app landing page #2678 (@Taha-Hassan-Git)
• Grouping examples into categories #2585 (@Taha-Hassan-Git @steveruizok)
• Add button to Examples to request an example #2597 (@Taha-Hassan-Git @steveruizok)
• Update README and examples copy in the docs #2594 (@Taha-Hassan-Git)
• Remove repeated word in CONTRIBUTING.md #2651 (@albjoh2)
• Update layout.tsx #2619 (@steveruizok)
• Add context toolbar example. #2596 (@MitjaBezensek @Taha-Hassan-Git)
• Use simple example #2561 (@steveruizok)
• fix: replaced dead links #2567 (@alikiki @steveruizok)
• add keyboard shortcuts example #2474 (@Taha-Hassan-Git)
• Fix translations link #2477 (@steveruizok)
• rename and annotate user presence example #2462 (@Taha-Hassan-Git @steveruizok)
• annotate onthecanvas example #2459 (@Taha-Hassan-Git)
• annotate snapshot example #2454 (@Taha-Hassan-Git)
• Fix and annotate minimal example #2448 (@Taha-Hassan-Git)
• annotate zones example #2461 (@Taha-Hassan-Git)
• annotate ui events example #2460 (@Taha-Hassan-Git)
• Annotate shape meta data example #2453 (@Taha-Hassan-Git)
• Annotate example for using Tldraw component in a scrollable container #2452 (@Taha-Hassan-Git)
• Annotate example for making editor read-only #2451 (@Taha-Hassan-Git)
• Fix typos and add comments for persistence example #2450 (@Taha-Hassan-Git)
• annotate external sources example #2414 (@Taha-Hassan-Git @steveruizok)
• Update README #2444 (@steveruizok)
• annotate multiple example #2431 (@Taha-Hassan-Git @steveruizok)
• annotate force mobile example #2421 (@Taha-Hassan-Git)
• annotate hosted images example #2422 (@Taha-Hassan-Git)
• annotate local images example #2423 (@Taha-Hassan-Git)
• annotate meta oncreate example #2426 (@Taha-Hassan-Git)
• Annotate exploded example #2413 (@Taha-Hassan-Git)
• annotate hide-ui example #2420 (@Taha-Hassan-Git)
• Annotate custom ui example #2408 (@Taha-Hassan-Git)
• Custom components annotation #2403 (@Taha-Hassan-Git)
• annotate meta onchange #2430 (@Taha-Hassan-Git)
• @tldraw/tldraw
  • Examples tweaks #2681 (@steveruizok)
• @tldraw/editor
  • fix typo in hideRotateHandle method #2473 (@Taha-Hassan-Git)

🧪 Tests

• @tldraw/editor, @tldraw/store, @tldraw/tldraw, @tldraw/utils
  • Bump jest to fix weird prettier bug #2716 (@steveruizok)

🔩 Dependency Updates

• @tldraw/editor, @tldraw/state, @tldraw/store, @tldraw/tldraw, @tldraw/tlschema, @tldraw/utils, @tldraw/validate
  • Bump Yarn to 4.0.2 and add version constraints #2481 (@si14)

Authors: 13

• @huppy-bot[bot]
• @Rokixy
• a22albjo (@albjoh2)
• Alex (@alikiki)
• alex (@SomeHats)
• Dan Groshev (@si14)
• David Sheldrick (@ds300)
• Lu Wilson (@TodePond)
• Mime Čuvalo (@mimecuvalo)
• Mitja Bezenšek (@MitjaBezensek)
• Peiling Jiang (@peilingjiang)
• Steve Ruiz (@steveruizok)
• Taha (@Taha-Hassan-Git)