760fd7b3a6
* feat: support arrow with text * render arrow -> clear rect-> render text * move bound text when linear elements move * fix centering cursor when linear element rotated * fix y coord when new line added and container has 3 points * update text position when 2nd point moved * support adding label on top of 2nd point when 3 points are present * change linear element editor shortcut to cmd+enter and fix tests * scale bound text points when resizing via bounding box * ohh yeah rotation works :) * fix coords when updating text properties * calculate new position after rotation always from original position * rotate the bound text by same angle as parent * don't rotate text and make sure dimensions and coords are always calculated from original point * hardcoding the text width for now * Move the linear element when bound text hit * Rotation working yaay * consider text element angle when editing * refactor * update x2 coords if needed when text updated * simplify * consider bound text to be part of bounding box when hit * show bounding box correctly when multiple element selected * fix typo * support rotating multiple elements * support multiple element resizing * shift bound text to mid point when odd points * Always render linear element handles inside editor after element rendered so point is visible for bound text * Delete bound text when point attached to it deleted * move bound to mid segement mid point when points are even * shift bound text when points nearby deleted and handle segment deletion * Resize working :) * more resize fixes * don't update cache-its breaking delete points, look for better soln * update mid point cache for bound elements when updated * introduce wrapping when resizing * wrap when resize for 2 pointer linear elements * support adding text for linear elements with more than 3 points * export to svg working :) * clip from nearest enclosing element with non transparent color if present when exporting and fill with correct color in canvas * fix snap * use visible elements * Make export to svg work with Mask :) * remove id * mask canvas linear element area where label is added * decide the position of bound text during render * fix coords when editing * fix multiple resize * update cache when bound text version changes * fix masking when rotated * render text in correct position in preview * remove unnecessary code * fix masking when rotating linear element * fix masking with zoom * fix mask in preview for export * fix offsets in export view * fix coords on svg export * fix mask when element rotated in svg * enable double-click to enter text * fix hint * Position cursor correctly and text dimensiosn when height of element is negative * don't allow 2 pointer linear element with bound text width to go beyond min width * code cleanup * fix freedraw * Add padding * don't show vertical align action for linear element containers * Add specs for getBoundTextElementPosition * more specs * move some utils to linearElementEditor.ts * remove only :p * check absoulte coods in test * Add test to hide vertical align for linear eleemnt with bound text * improve export preview * support labels only for arrows * spec * fix large texts * fix tests * fix zooming * enter line editor with cmd+double click * Allow points to move beyond min width/height for 2 pointer arrow with bound text * fix hint for line editing * attempt to fix arrow getting deselected * fix hint and shortcut * Add padding of 5px when creating bound text and add spec * Wrap bound text when arrow binding containers moved * Add spec * remove * set boundTextElementVersion to null if not present * dont use cache when version mismatch * Add a padding of 5px vertically when creating text * Add box sizing content box * Set bound elements when text element created to fix the padding * fix zooming in editor * fix zoom in export * remove globalCompositeOperation and use clearRect instead of fillRect
Virtual whiteboard for sketching hand-drawn like diagrams.
Collaborative and end-to-end encrypted.
Ask questions or hang out on our discord.gg/UexuTaE.
Try it now
Go to excalidraw.com to start sketching.
Read the latest news and updates on our blog. A good start is to see all the updates of One Year of Excalidraw.
Supporting Excalidraw
If you like the project, you can become a sponsor at Open Collective.
Last but not least, we're thankful to these companies for offering their services for free:
Who's integrating Excalidraw
Google Cloud • Meta • CodeSandbox • Obsidian Excalidraw • Replit • Slite • Notion • HackerRank •
Documentation
Shortcuts
You can almost do anything with shortcuts. Click on the help icon on the bottom right corner to see them all.
Curved lines and arrows
Choose line or arrow and click click click instead of drag.
Charts
You can easily create charts by copy pasting data from Excel or just plain comma separated text.
Translating
To translate Excalidraw into other languages, please visit our Crowdin page. To add a new language, open an issue so we can get things set up on our end first.
Translations will be available on the app if they exceed a certain threshold of completion (currently 85%).
Create a collaboration session manually
In order to create a session manually, you just need to generate a link of this form:
https://excalidraw.com/#room=[0-9a-f]{20},[a-zA-Z0-9_-]{22}
Example
https://excalidraw.com/#room=91bd46ae3aa84dff9d20,pfLqgEoY1c2ioq8LmGwsFA
The first set of digits is the room. This is visible from the server that’s going to dispatch messages to everyone that knows this number.
The second set of digits is the encryption key. The Excalidraw server doesn’t know about it. This is what all the participants use to encrypt/decrypt the messages.
Note: Please ensure that the encryption key is 22 characters long.
Shape libraries
Find a growing list of libraries containing assets for your drawings at libraries.excalidraw.com.
Embedding Excalidraw in your App?
Try out @excalidraw/excalidraw. This package allows you to easily embed Excalidraw as a React component into your apps.
Development
Code Sandbox
- Go to https://codesandbox.io/p/github/excalidraw/excalidraw
- You may need to sign in with GitHub and reload the page
- You can start coding instantly, and even send PRs from there!
Local Installation
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
Requirements
Clone the repo
git clone https://github.com/excalidraw/excalidraw.git
Install the dependencies
yarn
Start the server
yarn start
Now you can open http://localhost:3000 and start coding in your favorite code editor.
Collaboration
For collaboration, you will need to set up collab server in local.
Commands
Install the dependencies
yarn
Run the project
yarn start
Reformat all files with Prettier
yarn fix
Run tests
yarn test
Update test snapshots
yarn test:update
Test for formatting with Prettier
yarn test:code
Docker Compose
You can use docker-compose to work on Excalidraw locally if you don't want to setup a Node.js env.
docker-compose up --build -d
Self-hosting
We publish a Docker image with the Excalidraw client at excalidraw/excalidraw. You can use it to self-host your own client under your own domain, on Kubernetes, AWS ECS, etc.
docker build -t excalidraw/excalidraw .
docker run --rm -dit --name excalidraw -p 5000:80 excalidraw/excalidraw:latest
The Docker image is free of analytics and other tracking libraries.
At the moment, self-hosting your own instance doesn't support sharing or collaboration features.
We are working towards providing a full-fledged solution for self-hosting your own Excalidraw.
Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Notable used tools
And the main source of inspiration for starting the project is the awesome Zwibbler app.