OSS Tanbou

tldraw — a React infinite-canvas SDK for custom apps, multiplayer collaboration, and AI canvas workflows

OSS health 96
About these scores

Discovery score is an unbounded weighted, log-compressed index of stars, watchers, forks, and contributors. Growth momentum is its change over the observed period; OSS health is a 0–100 score from available repository recency, Community Health, and release data.

Stars
50,367
Primary language
TypeScript
License
Not determined
Repository last updated
Sep 15, 2026

Overview

tldraw is an SDK for embedding an infinite canvas in React applications. It provides drawing, shapes, rich text, arrows, media, custom shapes and tools, bindings, UI components, a runtime Editor API, and self-hostable multiplayer. MIT-licensed starter kits cover agent, workflow, chat, and other canvas patterns, making tldraw most useful as a foundation for custom visual applications rather than only as a finished whiteboard.

Features and best fit

Based on official documentation; not hands-on tested · Content checked:

Embed a full infinite-canvas engine and customize shapes, tools, bindings, and UI

The official README describes tldraw as a feature-complete infinite canvas engine for building canvas applications. Its default capabilities include pressure-sensitive drawing, geometric shapes, rich text, arrows, snapping, image and video support, and image export, while custom shapes, tools, bindings, UI components, side effects, and event hooks let a product replace or extend the default whiteboard behavior.

Sources: [1]

Use the Editor API and self-hostable multiplayer as application-state and collaboration infrastructure

tldraw exposes a runtime Editor API for driving the canvas programmatically and provides real-time collaboration through @tldraw/sync. The README explicitly describes multiplayer as self-hostable, making the SDK relevant not only to shared whiteboards and diagramming but also to products that connect canvas state to domain data and application workflows.

Sources: [1]

Start AI and visual-workflow products from Agent, Workflow, Chat, and other starter kits

The README documents canvas primitives for building with LLMs and starter kits for Multiplayer, Agent, Workflow, Chat, Image pipeline, Branching chat, and Shader use cases. The starter kits are MIT-licensed, providing reference code for agents that read and modify canvas content, node-based automation, visual AI conversations, and image-generation pipelines.

Sources: [1][2]

Best suited to teams embedding a canvas into a product rather than adopting a fixed whiteboard

tldraw is a strong fit for custom diagram editors, collaborative whiteboards, visual programming, workflow builders, AI chat canvases, and image pipelines built in React. Its value is highest when product-specific interactions need to combine custom shapes, tools, UI, sync, and runtime APIs rather than simply using a standard whiteboard unchanged.

The SDK uses a custom license, and production deployment requires an appropriate license key

The tldraw SDK itself is not MIT-licensed. Its custom license allows use in development, testing, and staging environments, but generally prohibits use in a Production Environment that provides functionality to end users or the public unless a trial or commercial agreement supplies the required License Key. The license also prohibits disabling or interfering with license-key enforcement.

The license states that technical enforcement may validate license keys and deployment environments and may transmit usage data to tldraw for license-compliance purposes. By contrast, the starter kits called out in the README are MIT-licensed. Teams should therefore distinguish starter-kit code from the SDK license and review the applicable terms before a production deployment.

Sources: [3][1]

Official sources

  1. [1]tldraw/tldraw — README(2026-09-15)
  2. [2]tldraw — create-tldraw(2026-09-15)
  3. [3]tldraw/tldraw — LICENSE(2026-09-15)
Supplemental curator note

We selected tldraw as an SDK for embedding product-specific canvas experiences rather than as a finished whiteboard. Before adoption, distinguish the SDK's custom license from MIT-licensed starter-kit code and verify the License Key requirements that apply to Production Environments.

Try it in 3 steps

  1. 1

    Install the package

    Add the tldraw package to an existing React application as shown in the official README quick start.

    npm i tldraw
  2. 2

    Import the component and CSS

    Import the Tldraw component and the standard stylesheet.

    import { Tldraw } from 'tldraw'; import 'tldraw/tldraw.css'
  3. 3

    Render the canvas

    Fill the viewport with Tldraw and verify the default drawing, shapes, and text interactions.

    <div style={{ position: 'fixed', inset: 0 }}><Tldraw /></div>
Check the official README

Growth

Growth trends · Last 30 days

50,367 Stars

Trend data is still being collected.

Development activity

Last 90 days · weekly

Commits (last 30 days)
335
Open PRs
194

Development activity is still being collected.

Built with

Categories and tags

GitHub data

GitHub dataView detailed GitHub data

GitHub Topics

  • drawing
  • sketch
  • whiteboard
  • canvas
  • diagram
  • infinite
  • react
  • collaboration
  • design
  • multiplayer
  • sync
  • sdk
Stars
50,367
Forks
3,508
Watchers
174
Open issues
459
Primary language
TypeScript
License
Not determined
Repository last updated
Sep 15, 2026
Report incorrect information

Tell us if any listing information is incorrect or outdated.