Virtual whiteboard for sketching hand-drawn like diagrams

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

website: https://excalidraw.com

Márk Tolmács 8e27de2cdc fix: Frame dimensions change by stats don't include new elements (#9568) 1 ماه پیش
.codesandbox 50450a7dab chore: update required node version to 18 (#6837) 2 سال پیش
.github 3f194918e6 feat: add mulitplatform Docker image support (#9594) 1 ماه پیش
.husky d0b33d35db build: temporarily disable pre-commit (#6132) 2 سال پیش
dev-docs a7b64f02b3 fix: remove image preview on image insertion (#9626) 1 ماه پیش
examples 95d89a751a refactor: decouple radio button selection from `.buttonList` wrapper (#9528) 2 ماه پیش
excalidraw-app d108053351 feat: various delta improvements (#9571) 1 ماه پیش
firebase-project 7431ca81d1 fix: update `storage.rules` (#5020) 3 سال پیش
packages 8e27de2cdc fix: Frame dimensions change by stats don't include new elements (#9568) 1 ماه پیش
public ef9ea14a75 fix: remove manifest.json (#8783) 9 ماه پیش
scripts 432a46ef9e refactor: separate elements logic into a standalone package (#9285) 4 ماه پیش
.dockerignore 8d530cf102 fix: Docker build in CI (#8312) 1 سال پیش
.editorconfig 8dccc793ee add editorconfig (#1198) 5 سال پیش
.env.development 14d512f321 Fix import.meta.env.MODE being undefined in host apps 2 ماه پیش
.env.production 14d512f321 Fix import.meta.env.MODE being undefined in host apps 2 ماه پیش
.eslintignore 6959a363f0 feat: canvas search (#8438) 11 ماه پیش
.eslintrc.json 4a60fe3d22 fix: remove `noreferrer` on internal links (#9452) 3 ماه پیش
.gitattributes c814917927 Add gitattributes (#2164) 4 سال پیش
.gitignore cc571c4681 chore: init CLAUDE.md (#9563) 2 ماه پیش
.lintstagedrc.js 5d295415db Keep errors, elements and comments consistent (#2340) 4 سال پیش
.npmrc 5b7596582f feat: color picker redesign (#6216) 2 سال پیش
.nvmrc 50450a7dab chore: update required node version to 18 (#6837) 2 سال پیش
.prettierignore 89cf826555 Change target branch of coverage and pretty print (#1850) 5 سال پیش
.watchmanconfig 24fa657093 Don't reset cache while zooming using a gesture (#1103) 5 سال پیش
CLAUDE.md cc571c4681 chore: init CLAUDE.md (#9563) 2 ماه پیش
CONTRIBUTING.md f23cdc47ee docs: migrating dev docs to docusaurus :) (#6073) 2 سال پیش
Dockerfile 3f194918e6 feat: add mulitplatform Docker image support (#9594) 1 ماه پیش
LICENSE 6f33d72e35 Add MIT License (#176) 5 سال پیش
README.md 41c036e1a5 chore: Add DeepWiki badge (#9559) 2 ماه پیش
crowdin.yml d6cd8b78f1 build: decouple package deps and introduce yarn workspaces (#7415) 1 سال پیش
docker-compose.yml baf9da2b83 chore: Update action versions and docker build (#3065) 4 سال پیش
package.json e058a08b33 fix: use rimraf instead of rm -rf (#9460) 3 ماه پیش
setupTests.ts b5d60973b7 fix: duplication tests pointer state leaking between tests (#9414) 3 ماه پیش
tsconfig.json 432a46ef9e refactor: separate elements logic into a standalone package (#9285) 4 ماه پیش
vercel.json 230d0edc44 feat: multiple fonts fallbacks (#8286) 1 سال پیش
vitest.config.mts 432a46ef9e refactor: separate elements logic into a standalone package (#9285) 4 ماه پیش
yarn.lock e058a08b33 fix: use rimraf instead of rm -rf (#9460) 3 ماه پیش

README.md


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

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

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

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

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

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