Welcome to the developer docs for tldraw, a React library for creating whiteboards and other infinite canvas experiences. These docs are for the 2.0 version which is currently in alpha.

tldraw demotldraw demo

What can I do with tldraw?

You can use the Tldraw React component to embed a fully featured and extendable whiteboard in your app. See the CodeSandbox for a minimal example.

For multiplayer whiteboards, you can plug the component into the collaboration backend of your choice. Check out our Yjs example to see how you might use tldraw together with Yjs.

You can use the Editor API to create, update, and delete shapes, control the camera—or do just about anything else. You can extend tldraw with your own custom shapes and custom tools. You can use our user interface overrides to change the contents of menus and toolbars, or else hide the UI and replace it with your own.

If you want to go even deeper, you can use the TldrawEditor component as a more minimal engine without the default tldraw shapes or user interface.

How do I learn tldraw?

In addition to the docs on this website, we provide many examples in the tldraw repo that demonstrate different ways of using the tldraw library. You can view them running here; or else you can clone the tldraw repo and start a local development server to see them in action.

You can ask questions and get help on our Discord channel or in our Github issues.

Community

Found a bug or want to request a feature? Create an issue here. To connect with the team and other users, join us on our Discord. To follow along with updates, you can also subscribe to our Substack newsletter or follow us on Twitter/X.

License

tldraw's source code and distributed packages are provided under the non-commercial tldraw license.

This license does not permit commercial use. If you wish to use tldraw in a commercial product or enterprise, you will need to purchase a commercial license. To obtain a commercial license, please contact us at hello@tldraw.com.

To learn more, see our license page.

Installation