tldraw/apps/docs/content/getting-started/introduction.mdx

50 lines
2.2 KiB
Text
Raw Normal View History

2023-04-25 11:01:25 +00:00
---
title: Introduction
status: published
author: steveruizok
date: 3/22/2023
order: 0
---
Welcome to the tldraw developer docs.
Here at tldraw, we make two things: a very good multiplayer whiteboard (at [tldraw.com](https://tldraw.com)), and the [open source library](https://github.com/tldraw/tldraw) that powers it. This page provides documentation and reference for that open source library.
2023-04-25 11:01:25 +00:00
```tsx
2023-04-25 11:01:25 +00:00
import { Tldraw } from '@tldraw/tldraw'
import '@tldraw/tldraw/tldraw.css'
2023-04-25 11:01:25 +00:00
export default function () {
return (
<div style={{ position: 'fixed', inset: 0 }}>
2023-04-25 11:01:25 +00:00
<Tldraw />
</div>
)
}
```
You can use the `<Tldraw>` React component to build on top of the default tldraw experience. It's easy to use and easy to extend with your own [custom shapes](/docs/shapes), [custom tools](/docs/tools), and [user interface](/docs/user-interface) overrides.
2023-04-25 11:01:25 +00:00
You can also use the [Editor API](/docs/editor) to create, update, and delete shapes, control the camera, or do just about anything else.
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.
2023-04-25 11:01:25 +00:00
Best of all, you can easily plug tldraw into the [collaboration backend](/docs/collaboration) of your choice.
2023-04-25 11:01:25 +00:00
- Want to explore the code? Visit the [GitHub repo](https://github.com/tldraw/tldraw).
- Want to try it out? Visit the [examples sandbox](https://stackblitz.com/github/tldraw/tldraw/tree/examples?file=src%2F1-basic%2FBasicExample.tsx).
2023-04-25 11:01:25 +00:00
Otherwise, continue on to the [installation](/docs/installation) and [usage](/docs/usage) guides.
2023-04-25 11:01:25 +00:00
## Community
2023-04-25 11:01:25 +00:00
Found a bug or want to request a feature? Create an issue [here](https://github.com/tldraw/tldraw/issues). To connect with the team and other users, join us on our [Discord](https://discord.gg/JMbeb96jsh).
2023-04-25 11:01:25 +00:00
If you spot an issue with these docs, please use the links at the bottom of each page to suggest a change.
2023-04-25 11:01:25 +00:00
## License
Our open source libraries are licensed and distributed under Apache-2.0.
2023-04-25 11:01:25 +00:00
Our plan is to keep these libraries permissively licensed while we develop a commercial offering for teams who want more from tldraw. If you're planning to use use tldraw in a commercial product, please reach out at [hello@tldraw.com](mailto://hello@tldraw.com).