Virtual whiteboard for sketching hand-drawn like diagrams
 
 
 
 
Go to file
Mark Tolmacs 3fe9d3509d
Trigger CI
.codesandbox chore: update required node version to 18 ()
.github fix: usage of `node12 which is deprecated` ()
.husky build: temporarily disable pre-commit ()
dev-docs docs: add demo link for browser integration ()
examples/excalidraw fix: Comic Shanns issues, new fonts structure ()
excalidraw-app Remove arc related code
firebase-project fix: update `storage.rules` ()
packages Trigger CI
public fix: remove manifest.json ()
scripts fix: merge server-side fonts with liberation sans ()
.dockerignore fix: Docker build in CI ()
.editorconfig add editorconfig ()
.env.development build: set PWA flag in dev to false ()
.env.production fix: load env vars correctly and set debug and linter flags to false explicitly in prod mode ()
.eslintignore feat: canvas search ()
.eslintrc.json feat: update jotai ()
.gitattributes Add gitattributes ()
.gitignore build: create ESM build for utils package 🥳 ()
.lintstagedrc.js Keep errors, elements and comments consistent ()
.npmrc feat: color picker redesign ()
.nvmrc chore: update required node version to 18 ()
.prettierignore Change target branch of coverage and pretty print ()
.watchmanconfig Don't reset cache while zooming using a gesture ()
CONTRIBUTING.md docs: migrating dev docs to docusaurus :) ()
Dockerfile fix: Docker build in CI ()
LICENSE Add MIT License ()
README.md fix: update old blog links & add canonical url ()
crowdin.yml build: decouple package deps and introduce yarn workspaces ()
docker-compose.yml chore: Update action versions and docker build ()
package.json fix: cleanup scripts and support upto node 22 ()
setupTests.ts perf: Improved pointer events related performance when the sidebar is docked with a large library open ()
tsconfig.json docs: add next js with app router example ()
vercel.json feat: multiple fonts fallbacks ()
vitest.config.mts feat: self-hosting existing google fonts ()
yarn.lock chore: update firebase@8 to @11 ()

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 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.

npm install react react-dom @excalidraw/excalidraw

or via yarn

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