Virtual whiteboard for sketching hand-drawn like diagrams
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Go to file
Marcel Mraz 260706c42f First step towards delta based history
Introducing independent change detection for appState and elements

Generalizing object change, cleanup, refactoring, comments, solving typing issues

Shaping increment, change, delta hierarchy

Structural clone of elements

Introducing store and incremental API

Disabling buttons for canvas actions, smaller store and changes improvements

Update history entry based on latest changes, iterate through the stack for visible changes to limit empty commands

Solving concurrency issues, solving (partly) linear element issues,  introducing commitToStore breaking change

Fixing existing tests, updating snapshots

Trying to be smarter on the appstate change detection

Extending collab test, refactoring action / updateScene params, bugfixes

Resetting snapshots

Resetting snapshots

UI / API tests for history - WIP

Changing actions related to the observed appstate to at least update the store snapshot - WIP

Adding skipping of snapshot update flag for most no-breaking changes compatible solution

Ignoring uncomitted elements from local async actions, updating store directly in updateScene

Bound element issues - WIP
1 year ago
.codesandbox chore: update required node version to 18 (#6837) 2 years ago
.github feat: update logo (#6979) 2 years ago
.husky build: temporarily disable pre-commit (#6132) 2 years ago
dev-docs First step towards delta based history 1 year ago
excalidraw-app First step towards delta based history 1 year ago
firebase-project fix: update `storage.rules` (#5020) 3 years ago
public fix: Icon size in manifest (#7073) 2 years ago
scripts fix: use subdirectory for @excalidraw/excalidraw size limit (#6787) 2 years ago
src First step towards delta based history 1 year ago
.dockerignore build: stops ignoring .env files from docker context so env variables get set during react app build. (#5809) 2 years ago
.editorconfig add editorconfig (#1198) 5 years ago
.env.development fix: export to plus url (#6980) 2 years ago
.env.production fix: export to plus url (#6980) 2 years ago
.eslintignore feat: image support (#4011) 3 years ago
.eslintrc.json chore: Update Typescript to 4.4.4 (#4188) 3 years ago
.gitattributes Add gitattributes (#2164) 5 years ago
.gitignore build: migrate to Vite 🚀 (#6818) 2 years ago
.lintstagedrc.js Keep errors, elements and comments consistent (#2340) 4 years ago
.npmrc feat: color picker redesign (#6216) 2 years ago
.nvmrc chore: update required node version to 18 (#6837) 2 years ago
.prettierignore Change target branch of coverage and pretty print (#1850) 5 years ago
.watchmanconfig Don't reset cache while zooming using a gesture (#1103) 5 years ago
CONTRIBUTING.md docs: migrating dev docs to docusaurus :) (#6073) 2 years ago
Dockerfile build: update to node 18 in docker (#6822) 2 years ago
LICENSE Add MIT License (#176) 5 years ago
README.md docs: add npm downloads rate badge to README.md file (#7127) 1 year ago
crowdin.yml Locale 5 years ago
docker-compose.yml chore: Update action versions and docker build (#3065) 4 years ago
index.html feat: update logo (#6979) 2 years ago
package.json indices with jitter 1 year ago
tsconfig-types.json build: migrate to Vite 🚀 (#6818) 2 years ago
tsconfig.json refactor: move excalidraw-app outside src (#6987) 2 years ago
vercel.json feat: redirect vscode.excalidraw.com to vscode marketplace (#5285) 3 years ago
vite.config.ts fix: Icon size in manifest (#7073) 2 years ago
vitest.config.ts feat: Support mermaid flowchart and sequence diagrams to excalidraw diagrams 🥳 (#6920) 1 year ago
yarn.lock indices with jitter 1 year ago

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

Install the Excalidraw npm package:

npm install react react-dom @excalidraw/excalidraw

or via yarn

yarn add react react-dom @excalidraw/excalidraw

Don't forget to check out our Documentation!

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