mrkeyoor.com_
Tue 01 Sept 17:43 UTC
Webevaluationupdated 26 Aug 2026

excalidraw review

Excalidraw is a React whiteboard for hand-drawn diagrams, wireframes, and freeform sketches. Its public app adds offline use, live collaboration, end-to-end encryption, and shareable links, while the npm package supplies the editor that developers can put inside another product.

+307stars / 7d
Verdict

Our Excalidraw checkout could not finish its 40-second install because Yarn ran under Node 18.20.8 and marked@16.4.2 required Node 20 or newer, so source contributors should verify the runtime before judging the code. The editor remains an easy recommendation for a React product that needs informal drawing and can own storage around it. Choose the full app or another platform if collaboration and account features must arrive as a supported package rather than application code.

We ran it

Lab card: what happened when we ran excalidrawScreenshot of excalidraw (excalidraw.com)
Install✗ · 40s
Build
Repo1271 files~197,620 lines of source · 55.7 MB · 11 CI workflows · Dockerfile

Answers from our run

Does excalidraw build from source?

The dependency install failed, and the project has no separate build step. We cloned commit e1bb9ff into a clean Debian container with 3 CPUs and no project-specific setup.

Who should not use excalidraw?

Non-React applications seeking a framework-neutral widget: the quick start requires React and React DOM.

What are the alternatives to excalidraw?

tldraw, diagrams.net, AFFiNE. Our Excalidraw checkout could not finish its 40-second install because Yarn ran under Node 18.

Setup2/5Install stopped on a Node engine mismatch after 40 seconds
Docs4/5Clear package split, with source setup moved to a separate guide
Community5/5130,570 stars and a push on August 26, 2026
Maturity5/5MIT project with active fixes and a long-used editor package

Discussed on

  1. hnWhy is Excalidraw so good?738 points
  2. hnI use Excalidraw to manage my diagrams for my blog283 points
  3. hnExcalidraw whiteboard – easily sketch diagrams with a hand-drawn feel241 points
  4. hnExcalidraw+ Is Now SoC 2 Certified234 points
  5. hnOpen-source drawing tool – Excalidraw184 points

Who it’s for

React teams that need an embeddable drawing canvas with an open JSON format.
People who want a fast, informal diagramming surface that can export PNG or SVG.
Product teams prepared to build their own storage and collaboration layer around the editor package.
Self-hosters willing to operate the full Excalidraw app rather than only install the component.

Who it’s NOT for

Non-React applications seeking a framework-neutral widget: the quick start requires React and React DOM.
Teams assuming the npm package includes live collaboration and encrypted sharing: the README assigns those features to the Excalidraw.com app and describes package plugins only as a future intention.
Buyers who need formal diagram semantics, validation, or code generation: the documented tools make freeform drawings and exports, not schema-checked models.
Developers pinned to Node 18 for repository work: our Yarn install stopped because one resolved package required Node 20 or newer.

Setup reality

Our sandbox checkout at commit e1bb9ff failed during yarn install after 40 seconds, before any build or test step. Yarn reported that marked@16.4.2 requires Node 20 or newer, while the process was using Node 18.20.8. The 55.7 MB monorepo contained 1,271 files and about 197,620 source lines.

Installing the published editor is simpler than developing the repository: the README asks for React, React DOM, and @excalidraw/excalidraw. The full app adds persistence, collaboration, encryption, and sharing concerns that an embedded editor does not solve for its host.

The repository has Yarn workspaces, a Dockerfile, a compose file, and 11 CI workflows. Its README sends contributors to a separate development guide, so the two-line package quick start should not be read as the complete source-build procedure.

The editor package is smaller than the hosted product

Excalidraw is often described as a whiteboard, but developers need to separate two products in this repository. The npm package is the canvas editor: shapes, arrows, free drawing, images, libraries, undo, zoom, localization, and PNG or SVG export. Excalidraw.com wraps that editor in a progressive web app with browser autosave, live collaboration, end-to-end encryption, and read-only sharing. That distinction decides how much work follows an install.

The package is a good fit when a React application needs sketching inside an existing workflow. Drawings can be exported as an .excalidraw JSON file, so users are not restricted to a flattened image. The loose hand-drawn style also changes how diagrams are received. Early architecture thoughts and wireframes look provisional, which can invite edits more readily than a polished chart.

React is required, and collaboration is still application work

The quick start installs React, React DOM, and @excalidraw/excalidraw. That is pleasantly direct for an existing React product. It is less useful to a Vue, Svelte, native, or server-rendered application that wants a framework-neutral component. A team can isolate the editor behind its own boundary, but that is integration work the documented package does not remove.

Collaboration deserves the same precision. The README lists real-time collaboration, encryption, offline support, local browser saving, and shareable links under Excalidraw.com. It then says those features may become drop-in plugins for the npm package in the future. That sentence is an aspiration, not a current package promise. If your product needs shared rooms, durable files, identity, recovery, or access rules, budget for the host application and backend.

What happened when we ran it

Our sandbox cloned commit e1bb9ff and ran the repository install with 3 CPUs and 8 GB of RAM. The checkout had 1,271 files, about 197,620 lines of source, and occupied 55.7 MB. yarn install failed with exit code 1 after 40 seconds, so we did not proceed to a build or test result.

The useful error was specific. Yarn 1.22.22 reached dependency fetching, warned about incompatible strip-ansi resolutions, then rejected marked@16.4.2. That package declared Node 20 or newer, while the install process reported Node 18.20.8. The log does not establish why that runtime was selected despite the lab image label, so it would be speculation to blame the repository, container, or package manager.

A clean source setup therefore needs a runtime check before a long workspace install. The repository is a monorepo with Yarn workspaces, 11 CI workflow files, a Dockerfile, and a compose file. There is no top-level tests directory in our scan. Those signals show serious project machinery, but they do not turn the README's package command into a contributor setup guide. The README correctly points source developers elsewhere.

The open file format is the strongest integration feature

The JSON drawing format is more useful than it first appears. A host product can keep editable scene data, let users return to a drawing, and also produce PNG, SVG, or clipboard output. Shape libraries and localization broaden the editor without forcing every team to build its own palette. Arrow binding and labels cover the common diagramming moves that a plain canvas library leaves to its integrator.

That freedom has a boundary. Excalidraw documents a drawing tool, not a modeling system that knows whether a network diagram is valid or whether a flowchart matches executable code. Teams needing governed symbols, generated infrastructure, or schema validation should look at a more formal diagram editor. Excalidraw is strongest when humans are communicating an idea and can tolerate loose structure.

A 2026 security release shows active maintenance

GitHub recorded 130,570 stars, 3,396 combined open issues and pull requests, and a last push on August 26, 2026. The open count is not a bug count, and the same-day push matters more than the size of that queue when judging whether the code is moving. Eleven CI workflow files also indicate that the maintainers automate several repository checks.

The latest GitHub release was v0.18.1 on April 21, 2026. Its notes call it a security patch for the 0.18 line, backporting a mitigation for an upstream Mermaid cross-site scripting flaw and pinning a TypeScript type package for compatibility. That is useful evidence of maintenance. It also tells teams embedding rendered Mermaid content to keep the editor dependency current rather than treating a working canvas as finished forever.

Pick Excalidraw for sketches, not a turnkey workspace

For an existing React product, the editor package has a sensible job and an MIT license. Users get familiar drawing tools, editable files, dark mode, images, reusable shape libraries, and several export routes. The host keeps control of where a drawing appears and how it connects to the rest of the product.

The buying decision changes when the requirement says shared whiteboard platform. Excalidraw.com proves that the editor can sit inside one, but its collaboration and encrypted sharing are app features today. Running that experience means understanding the full repository and its services. Our failed 40-second install is a modest warning to reproduce the contributor environment first. For sketching inside React, Excalidraw is still the first project I would trial; for governed diagrams or a ready-made team workspace, compare the alternatives before committing.

Alternatives

ProjectWhat it isPick it when
tldrawA React canvas SDK and collaborative whiteboard with a more application-oriented shape system.pick this instead when you want to build a custom canvas product and its SDK model fits better than Excalidraw's sketch-first editor.
diagrams.netA mature diagram editor aimed at structured flowcharts, architecture maps, and many export formats.pick this instead when formal diagrams and a large shape catalog matter more than a hand-drawn look.
AFFiNE gh↗A local-first workspace combining documents, whiteboards, and databases.pick this instead when the whiteboard must live inside a broader notes and workspace product.

What people are saying

  1. [velocity-scout] excalidraw/excalidraw

Sources

  1. Excalidraw README
  2. Excalidraw repository facts
  3. Excalidraw v0.18.1 release
  4. Excalidraw development guide

More web reviews

axios · super-productivity · Graphite · fastify · tabler · go-zero · the whole board →