Virtual whiteboard for sketching hand-drawn like diagrams

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

website: https://excalidraw.com

Marcel Mraz 6bcd5b622c Coderabbit test 5 miesięcy temu
.codesandbox 50450a7dab chore: update required node version to 18 (#6837) 2 lat temu
.github 6e0ee89ee4 fix: usage of `node12 which is deprecated` (#8791) 11 miesięcy temu
.husky d0b33d35db build: temporarily disable pre-commit (#6132) 2 lat temu
dev-docs debf2ad608 docs: Fix missing verb in Footer component documentation (#9393) 6 miesięcy temu
examples 95d89a751a refactor: decouple radio button selection from `.buttonList` wrapper (#9528) 5 miesięcy temu
excalidraw-app 7e41026812 refactor: export everything from `@excalidraw/element`, don't import from subpaths (#9466) 5 miesięcy temu
firebase-project 7431ca81d1 fix: update `storage.rules` (#5020) 3 lat temu
packages 91d36e9b81 fix: Linear to elbow conversion crash (#9556) 5 miesięcy temu
public ef9ea14a75 fix: remove manifest.json (#8783) 11 miesięcy temu
scripts 432a46ef9e refactor: separate elements logic into a standalone package (#9285) 7 miesięcy temu
.dockerignore 8d530cf102 fix: Docker build in CI (#8312) 1 rok temu
.editorconfig 8dccc793ee add editorconfig (#1198) 5 lat temu
.env.development f2e8404c7b feat: allow to disable preventUnload in dev (#9319) 7 miesięcy temu
.env.production df168a6883 fix: load env vars correctly and set debug and linter flags to false explicitly in prod mode (#8770) 11 miesięcy temu
.eslintignore 6959a363f0 feat: canvas search (#8438) 1 rok temu
.eslintrc.json 4a60fe3d22 fix: remove `noreferrer` on internal links (#9452) 6 miesięcy temu
.gitattributes c814917927 Add gitattributes (#2164) 5 lat temu
.gitignore ecef5d12f4 chore: release @excalidraw/[email protected] 🎉 (#9127) 8 miesięcy temu
.lintstagedrc.js 5d295415db Keep errors, elements and comments consistent (#2340) 5 lat temu
.npmrc 5b7596582f feat: color picker redesign (#6216) 2 lat temu
.nvmrc 50450a7dab chore: update required node version to 18 (#6837) 2 lat temu
.prettierignore 89cf826555 Change target branch of coverage and pretty print (#1850) 5 lat temu
.watchmanconfig 24fa657093 Don't reset cache while zooming using a gesture (#1103) 5 lat temu
CONTRIBUTING.md f23cdc47ee docs: migrating dev docs to docusaurus :) (#6073) 2 lat temu
Dockerfile 8d530cf102 fix: Docker build in CI (#8312) 1 rok temu
LICENSE 6f33d72e35 Add MIT License (#176) 5 lat temu
README.md 6bcd5b622c Coderabbit test 5 miesięcy temu
crowdin.yml d6cd8b78f1 build: decouple package deps and introduce yarn workspaces (#7415) 1 rok temu
docker-compose.yml baf9da2b83 chore: Update action versions and docker build (#3065) 4 lat temu
package.json e058a08b33 fix: use rimraf instead of rm -rf (#9460) 5 miesięcy temu
setupTests.ts b5d60973b7 fix: duplication tests pointer state leaking between tests (#9414) 6 miesięcy temu
tsconfig.json 432a46ef9e refactor: separate elements logic into a standalone package (#9285) 7 miesięcy temu
vercel.json 230d0edc44 feat: multiple fonts fallbacks (#8286) 1 rok temu
vitest.config.mts 432a46ef9e refactor: separate elements logic into a standalone package (#9285) 7 miesięcy temu
yarn.lock e058a08b33 fix: use rimraf instead of rm -rf (#9460) 5 miesięcy temu

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