Virtual whiteboard for sketching hand-drawn like diagrams

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

website: https://excalidraw.com

Marcel Mraz f16967fc52 Lint fix, comment fix 1 ano atrás
.codesandbox 50450a7dab chore: update required node version to 18 (#6837) 2 anos atrás
.github c6fdac131b ci: add the workspace ignore check to install actions as dependency for auto release (#7593) 1 ano atrás
.husky d0b33d35db build: temporarily disable pre-commit (#6132) 2 anos atrás
dev-docs 2789d08154 docs: update the docs for next js integration (#7605) 1 ano atrás
examples 966f9aead9 build(deps-dev): bump vite from 5.0.6 to 5.0.12 in /examples/excalidraw/with-script-in-browser (#7603) 1 ano atrás
excalidraw-app 0513b647ec feat: change collab trigger & add share dialog (#7647) 1 ano atrás
firebase-project 7431ca81d1 fix: update `storage.rules` (#5020) 3 anos atrás
packages f16967fc52 Lint fix, comment fix 1 ano atrás
public 41cc746885 fix: host font assets from root (#7548) 1 ano atrás
scripts 4f0a2a9593 docs: add next js with app router example (#7552) 1 ano atrás
.dockerignore d6cd8b78f1 build: decouple package deps and introduce yarn workspaces (#7415) 1 ano atrás
.editorconfig 8dccc793ee add editorconfig (#1198) 5 anos atrás
.env.development 4888d9d355 chore: change default port of collab server (#7641) 1 ano atrás
.env.production d426cc968d refactor: remove portal as it is no longer needed (#7623) 1 ano atrás
.eslintignore d6cd8b78f1 build: decouple package deps and introduce yarn workspaces (#7415) 1 ano atrás
.eslintrc.json 8d4f455cd3 chore: Update Typescript to 4.4.4 (#4188) 3 anos atrás
.gitattributes c814917927 Add gitattributes (#2164) 4 anos atrás
.gitignore 4f0a2a9593 docs: add next js with app router example (#7552) 1 ano atrás
.lintstagedrc.js 5d295415db Keep errors, elements and comments consistent (#2340) 4 anos atrás
.npmrc 5b7596582f feat: color picker redesign (#6216) 2 anos atrás
.nvmrc 50450a7dab chore: update required node version to 18 (#6837) 2 anos atrás
.prettierignore 89cf826555 Change target branch of coverage and pretty print (#1850) 5 anos atrás
.watchmanconfig 24fa657093 Don't reset cache while zooming using a gesture (#1103) 5 anos atrás
CONTRIBUTING.md f23cdc47ee docs: migrating dev docs to docusaurus :) (#6073) 2 anos atrás
Dockerfile 5dd1efde8a build: update to node 18 in docker (#6822) 2 anos atrás
LICENSE 6f33d72e35 Add MIT License (#176) 5 anos atrás
README.md 537f6e7f68 docs: add steps for local development (#7449) 1 ano atrás
crowdin.yml d6cd8b78f1 build: decouple package deps and introduce yarn workspaces (#7415) 1 ano atrás
docker-compose.yml baf9da2b83 chore: Update action versions and docker build (#3065) 4 anos atrás
package.json 678bb2b819 build(deps-dev): bump vite from 5.0.6 to 5.0.12 (#7586) 1 ano atrás
setupTests.ts d6cd8b78f1 build: decouple package deps and introduce yarn workspaces (#7415) 1 ano atrás
tsconfig.json 4f0a2a9593 docs: add next js with app router example (#7552) 1 ano atrás
vercel.json 41cc746885 fix: host font assets from root (#7548) 1 ano atrás
vitest.config.mts d6cd8b78f1 build: decouple package deps and introduce yarn workspaces (#7415) 1 ano atrás
yarn.lock 678bb2b819 build(deps-dev): bump vite from 5.0.6 to 5.0.12 (#7586) 1 ano atrás

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

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