Go to file
Archie Sengupta ec070911b8
Tests / test (push) Waiting to run Details
Auto release excalidraw next / Auto-release-excalidraw-next (push) Has been cancelled Details
Build Docker image / build-docker (push) Has been cancelled Details
Cancel previous runs / cancel (push) Has been cancelled Details
Publish Docker / publish-docker (push) Has been cancelled Details
New Sentry production release / sentry (push) Has been cancelled Details
feat: library search (#9903)
* feat(utils): add support for search input type in isWritableElement

* feat(i18n): add search text

* feat(cmdp+lib): add search functionality for command pallete and lib menu items

* chore: fix formats, and whitespaces

* fix: opt to optimal code changes

* chore: fix for linting

* focus input on mount

* tweak placeholder

* design and UX changes

* tweak item hover/active/seletected states

* unrelated: move publish button above delete/clear to keep it more stable

* esc to clear search input / close sidebar

* refactor command pallete library stuff

* make library commands bigger

---------

Co-authored-by: dwelle <5153846+dwelle@users.noreply.github.com>
2025-09-28 22:16:28 +02:00
.codesandbox chore: update required node version to 18 (#6837) 2023-07-31 23:47:41 +02:00
.github chore: release multiple packages (#9698) 2025-06-30 12:19:15 +02:00
.husky build: temporarily disable pre-commit (#6132) 2023-01-19 13:50:42 +01:00
dev-docs docs: fix broken update scene button example in docs (#9726) 2025-07-08 19:29:44 +05:30
examples chore: release multiple packages (#9698) 2025-06-30 12:19:15 +02:00
excalidraw-app fix: Remove local elements when there is room data during `startCollaboration` (#9786) 2025-09-23 22:18:41 +00:00
firebase-project fix: update `storage.rules` (#5020) 2022-04-17 22:47:00 +02:00
packages feat: library search (#9903) 2025-09-28 22:16:28 +02:00
public fix: remove manifest.json (#8783) 2024-11-09 13:42:11 +05:30
scripts feat: fix delta apply to issues (#9830) 2025-08-07 15:38:58 +02:00
.dockerignore fix: Docker build in CI (#8312) 2024-08-06 13:21:20 +02:00
.editorconfig add editorconfig (#1198) 2020-04-03 19:19:01 +02:00
.env.development Fix import.meta.env.MODE being undefined in host apps 2025-05-22 15:25:48 +02:00
.env.production Fix import.meta.env.MODE being undefined in host apps 2025-05-22 15:25:48 +02:00
.eslintignore feat: canvas search (#8438) 2024-09-09 17:12:07 +02:00
.eslintrc.json fix: remove `noreferrer` on internal links (#9452) 2025-04-29 18:45:17 +02:00
.gitattributes Add gitattributes (#2164) 2020-09-15 21:59:00 +02:00
.gitignore chore: init CLAUDE.md (#9563) 2025-05-25 21:23:40 +02:00
.lintstagedrc.js Keep errors, elements and comments consistent (#2340) 2020-11-05 18:06:18 +01:00
.npmrc feat: color picker redesign (#6216) 2023-05-18 16:06:27 +02:00
.nvmrc chore: update required node version to 18 (#6837) 2023-07-31 23:47:41 +02:00
.prettierignore Change target branch of coverage and pretty print (#1850) 2020-07-01 12:05:21 +03:00
.watchmanconfig Don't reset cache while zooming using a gesture (#1103) 2020-03-28 16:59:36 -07:00
CLAUDE.md chore: init CLAUDE.md (#9563) 2025-05-25 21:23:40 +02:00
CONTRIBUTING.md docs: migrating dev docs to docusaurus :) (#6073) 2023-02-01 19:57:54 +05:30
Dockerfile feat: add mulitplatform Docker image support (#9594) 2025-06-15 20:11:37 +02:00
LICENSE Add MIT License (#176) 2020-01-05 13:09:29 -08:00
README.md chore: Add DeepWiki badge (#9559) 2025-05-22 13:05:56 +02:00
crowdin.yml build: decouple package deps and introduce yarn workspaces (#7415) 2023-12-12 11:32:51 +05:30
docker-compose.yml chore: Update action versions and docker build (#3065) 2021-02-20 14:28:33 +00:00
package.json chore: release multiple packages (#9698) 2025-06-30 12:19:15 +02:00
setupTests.ts fix: duplication tests pointer state leaking between tests (#9414) 2025-04-18 11:11:12 +02:00
tsconfig.json refactor: separate elements logic into a standalone package (#9285) 2025-03-26 15:24:59 +01:00
vercel.json feat: multiple fonts fallbacks (#8286) 2024-07-30 10:34:40 +02:00
vitest.config.mts refactor: separate elements logic into a standalone package (#9285) 2025-03-26 15:24:59 +01:00
yarn.lock chore: bump mermaid-to-excalidraw to 1.1.3 (#9898) 2025-08-21 20:58:04 +02:00

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 Ask DeepWiki 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

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