Virtual whiteboard for sketching hand-drawn like diagrams

#whiteboard #app #selfhosted #docker #excel #mindmap #braindump #data #storage

website: https://excalidraw.com

David Luzar 2874f9e48c fix(editor): simplify and fix midpoint highlighting (#10832) 1 day ago
.codesandbox 50450a7dab chore: update required node version to 18 (#6837) 2 years ago
.github 1f47d61e8c chore: bump node in tests.yml (#10670) 1 month ago
.husky d0b33d35db build: temporarily disable pre-commit (#6132) 3 years ago
dev-docs 47cbb5b6fb refactor: single source of truths with editor interface (#10178) 3 months ago
examples 47cbb5b6fb refactor: single source of truths with editor interface (#10178) 3 months ago
excalidraw-app b0404b10b6 chore(debug): add debug.logChanged() and make easy to import (#10828) 2 days ago
firebase-project 7431ca81d1 fix: update `storage.rules` (#5020) 3 years ago
packages 2874f9e48c fix(editor): simplify and fix midpoint highlighting (#10832) 1 day ago
public 5bcd8280c9 feat: add comments/presi eplus promos for discoveribility (#10294) 3 months ago
scripts b9a255407f refactor: update SCSS syntax & remove open-color dep (#10633) 1 month ago
.dockerignore 8d530cf102 fix: Docker build in CI (#8312) 1 year ago
.editorconfig 8dccc793ee add editorconfig (#1198) 5 years ago
.env.development a0b98a944f feat: TextToDiagram v2 (#10530) 1 month ago
.env.production 14d512f321 Fix import.meta.env.MODE being undefined in host apps 9 months ago
.eslintignore 6959a363f0 feat: canvas search (#8438) 1 year ago
.eslintrc.json 4a60fe3d22 fix: remove `noreferrer` on internal links (#9452) 10 months ago
.gitattributes c814917927 Add gitattributes (#2164) 5 years ago
.gitignore cc571c4681 chore: init CLAUDE.md (#9563) 9 months ago
.lintstagedrc.js 5d295415db Keep errors, elements and comments consistent (#2340) 5 years ago
.npmrc 5b7596582f feat: color picker redesign (#6216) 2 years ago
.prettierignore 89cf826555 Change target branch of coverage and pretty print (#1850) 5 years ago
.watchmanconfig 24fa657093 Don't reset cache while zooming using a gesture (#1103) 5 years ago
CLAUDE.md cc571c4681 chore: init CLAUDE.md (#9563) 9 months ago
CONTRIBUTING.md f23cdc47ee docs: migrating dev docs to docusaurus :) (#6073) 3 years ago
Dockerfile 3f194918e6 feat: add mulitplatform Docker image support (#9594) 8 months ago
LICENSE 6f33d72e35 Add MIT License (#176) 6 years ago
README.md 06f01e11f8 style: remove blue lines (#10425) 2 months ago
crowdin.yml d6cd8b78f1 build: decouple package deps and introduce yarn workspaces (#7415) 2 years ago
docker-compose.yml 98e0cd9078 build: Docker compose version removed (#10074) 4 months ago
package.json d080833f4d chore: bump [email protected] (#10431) 2 months ago
setupTests.ts b5d60973b7 fix: duplication tests pointer state leaking between tests (#9414) 10 months ago
tsconfig.json 432a46ef9e refactor: separate elements logic into a standalone package (#9285) 11 months ago
vercel.json 230d0edc44 feat: multiple fonts fallbacks (#8286) 1 year ago
vitest.config.mts 432a46ef9e refactor: separate elements logic into a standalone package (#9285) 11 months ago
yarn.lock 063533aede feat(packages/excalidraw): support nested dropdown menu (#10749) 2 weeks ago

README.md


<img alt="Excalidraw is released under the MIT license." src="https://img.shields.io/badge/license-MIT-blue.svg"  /></a>

<img alt="npm downloads/month" src="https://img.shields.io/npm/dm/@excalidraw/excalidraw"  /></a>

<img alt="PRs welcome!" src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat"  /></a>

<img alt="Chat on Discord" src="https://img.shields.io/discord/723672430744174682?color=738ad6&label=Chat%20on%20Discord&logo=discord&logoColor=ffffff&widge=false"/></a>

<img alt="Ask DeepWiki" src="https://deepwiki.com/badge.svg" /></a>

<img alt="Follow Excalidraw on Twitter" src="https://img.shields.io/twitter/follow/excalidraw.svg?label=follow+@excalidraw&style=social&logo=twitter"/></a>

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