tldraw

tldraw is an infinite canvas SDK for React that ships as a yarn workspaces monorepo. The repository contains the SDK packages, the tldraw.com web app, the documentation site, a VS Code extension, and an MCP server, plus starter templates for common app shapes.

What is in this repo

• SDK packages under packages/ — the editor core, the full SDK, the reactive store, the schema, signals primitives, multiplayer sync, and shared utilities.
• Apps under apps/ — the tldraw.com client and Cloudflare workers, the docs site, the examples app, the VS Code extension, the MCP app, and the analytics worker.
• Templates under templates/ — starter projects (sync, agent, chat, workflow, vue, vite, next.js, etc.) for npx create-tldraw@latest.
• Internal tooling under internal/ — repo scripts (build, lint, typecheck, release), shared TS configs, and the health worker.

Tech stack

• Language: TypeScript 5.8+
• Runtime: React 18/19, Node ^20.0.0
• Package manager: Yarn 4 (Yarn workspaces)
• Build: lazyrepo for incremental builds
• Test: Vitest (unit), Playwright (e2e)
• Lint: oxlint + custom ESLint config
• Format: oxfmt + Prettier
• Backend / sync: Cloudflare Workers + Durable Objects, Postgres + Zero (apps/dotcom/zero-cache)
• Docs site: Next.js (apps/docs)
• Examples app: Vite (apps/examples)
• VS Code: webview-based extension (apps/vscode)

Where to start

• New to the codebase? Read Architecture and Getting started.
• Looking for vocabulary? See the Glossary.
• Want to know what changes look like? Read How to contribute.
• Looking for a specific package or app? Browse Packages and Apps.
• Want the cross-cutting story (sync, shapes, tools, the store)? See Features.

Quick links

• Public docs: https://tldraw.dev
• Hosted app: https://tldraw.com
• npm package: tldraw
• License: see LICENSE.md. Production use of the SDK requires a license key.