Go to file
Omar Brikaa 37ad85cbaf
Tests / test (push) Has been cancelled Details
fix: Fix the root cause of `flushSync` flickering (#9791)
* More reliable width and height change detection

* Put the dimensions useEffect before the scene render one, just in case
2025-07-27 23:52:07 +02:00
.codesandbox
.github chore: release multiple packages (#9698) 2025-06-30 12:19:15 +02:00
.husky
dev-docs docs: fix broken update scene button example in docs (#9726) 2025-07-08 19:29:44 +05:30
examples chore: release multiple packages (#9698) 2025-06-30 12:19:15 +02:00
excalidraw-app chore: Remove editingLinearElement (#9771) 2025-07-24 17:02:21 +02:00
firebase-project
packages fix: Fix the root cause of `flushSync` flickering (#9791) 2025-07-27 23:52:07 +02:00
public fix: remove manifest.json (#8783) 2024-11-09 13:42:11 +05:30
scripts chore: release multiple packages (#9698) 2025-06-30 12:19:15 +02:00
.dockerignore fix: Docker build in CI (#8312) 2024-08-06 13:21:20 +02:00
.editorconfig
.env.development Fix import.meta.env.MODE being undefined in host apps 2025-05-22 15:25:48 +02:00
.env.production Fix import.meta.env.MODE being undefined in host apps 2025-05-22 15:25:48 +02:00
.eslintignore feat: canvas search (#8438) 2024-09-09 17:12:07 +02:00
.eslintrc.json fix: remove `noreferrer` on internal links (#9452) 2025-04-29 18:45:17 +02:00
.gitattributes
.gitignore chore: init CLAUDE.md (#9563) 2025-05-25 21:23:40 +02:00
.lintstagedrc.js
.npmrc
.nvmrc
.prettierignore
.watchmanconfig
CLAUDE.md chore: init CLAUDE.md (#9563) 2025-05-25 21:23:40 +02:00
CONTRIBUTING.md
Dockerfile feat: add mulitplatform Docker image support (#9594) 2025-06-15 20:11:37 +02:00
LICENSE
README.md chore: Add DeepWiki badge (#9559) 2025-05-22 13:05:56 +02:00
crowdin.yml build: decouple package deps and introduce yarn workspaces (#7415) 2023-12-12 11:32:51 +05:30
docker-compose.yml
package.json chore: release multiple packages (#9698) 2025-06-30 12:19:15 +02:00
setupTests.ts fix: duplication tests pointer state leaking between tests (#9414) 2025-04-18 11:11:12 +02:00
tsconfig.json refactor: separate elements logic into a standalone package (#9285) 2025-03-26 15:24:59 +01:00
vercel.json feat: multiple fonts fallbacks (#8286) 2024-07-30 10:34:40 +02:00
vitest.config.mts refactor: separate elements logic into a standalone package (#9285) 2025-03-26 15:24:59 +01:00
yarn.lock fix: use rimraf instead of rm -rf (#9460) 2025-05-07 14:13:27 +02:00

README.md

Excalidraw

Excalidraw Editor | Blog | Documentation | Excalidraw+

An open source virtual hand-drawn style whiteboard.
Collaborative and end-to-end encrypted.


Excalidraw is released under the MIT license. npm downloads/month PRs welcome! Chat on Discord Ask DeepWiki Follow Excalidraw on Twitter

Product showcase

Create beautiful hand-drawn like diagrams, wireframes, or whatever you like.

Features

The Excalidraw editor (npm package) supports:

  • 💯 Free & open-source.
  • 🎨 Infinite, canvas-based whiteboard.
  • ✍️ Hand-drawn like style.
  • 🌓 Dark mode.
  • 🏗️ Customizable.
  • 📷 Image support.
  • 😀 Shape libraries support.
  • 🌐 Localization (i18n) support.
  • 🖼️ Export to PNG, SVG & clipboard.
  • 💾 Open format - export drawings as an .excalidraw json file.
  • ⚒️ Wide range of tools - rectangle, circle, diamond, arrow, line, free-draw, eraser...
  • ➡️ Arrow-binding & labeled arrows.
  • 🔙 Undo / Redo.
  • 🔍 Zoom and panning support.

Excalidraw.com

The app hosted at excalidraw.com is a minimal showcase of what you can build with Excalidraw. Its source code is part of this repository as well, and the app features:

  • 📡 PWA support (works offline).
  • 🤼 Real-time collaboration.
  • 🔒 End-to-end encryption.
  • 💾 Local-first support (autosaves to the browser).
  • 🔗 Shareable links (export to a readonly link you can share with others).

We'll be adding these features as drop-in plugins for the npm package in the future.

Quick start

Note: following instructions are for installing the Excalidraw npm package when integrating Excalidraw into your own app. To run the repository locally for development, please refer to our Development Guide.

Use npm or yarn to install the package.

npm install react react-dom @excalidraw/excalidraw
# or
yarn add react react-dom @excalidraw/excalidraw

Check out our documentation for more details!

Contributing

Integrations

Who's integrating Excalidraw

Google CloudMetaCodeSandboxObsidian ExcalidrawReplitSliteNotionHackerRank • and many others

Sponsors & support

If you like the project, you can become a sponsor at Open Collective or use Excalidraw+.

Thank you for supporting Excalidraw

Last but not least, we're thankful to these companies for offering their services for free:

Vercel Sentry Crowdin