What Excalidraw is

Excalidraw is an infinite hand-drawn whiteboard you can embed in your React app; check its 0.x API, App.tsx and hosted backends first.

Your team is deciding whether to embed the editor. The package is still on 0.x, and sharing, collaboration and AI depend on hosted services. So what does embedding commit you to?

  • It is a drawing surface. Users create, select, transform and restyle shapes, freehand strokes, text and images, with undo and redo.
  • It keeps a sketchy look. Shapes render through roughjs and perfect-freehand, and every change flows through a store.
  • It ships as a package. @excalidraw/excalidraw carries props, an imperative API and translations.
  • It does more than draw. The scan records 10 capabilities; 81 files carry a capability tag.
Label Label
Illustration, not a screenshot. The recorded flow: pick the rectangle tool, drag out a box, double-click to type a label, change the stroke color, press Ctrl+Z to undo it.

The answer: you can embed Excalidraw in a React app; check its 0.x API, App.tsx and hosted backends first.

How the code is organized

Capability-tagged code sits under packages/element, packages/excalidraw, excalidraw-app and scripts.

543

files

229

components

18

hooks

294

other files

2214

internal edges

LocationCapabilities tagged there includeTagged files include
packages/elementCanvas editor, structured diagrammingsrc/Scene.ts, src/store.ts, src/binding.ts, src/elbowArrow.ts
packages/excalidrawCanvas editor, export and file format, shape libraries, embeddable SDKcomponents/App.tsx, data/restore.ts, data/library.ts, index.tsx
excalidraw-appLive rooms, local-first persistence, AI, Excalidraw+ bridgedata/firebase.ts, data/LocalData.ts, components/AI.tsx, components/ExportToExcalidrawPlus.tsx
scriptsEmbeddable SDKbuildPackage.js, release.js

81 files carry a capability tag. The scan reports 543 files, and 149 found but excluded (tests and the like). Its one page is examples/with-nextjs/src/app/page.tsx; it records 0 API routes.

The answer: you can embed Excalidraw in a React app; check its 0.x API, App.tsx and hosted backends first.

The capabilities a team would use

Inside the editor, a team would draw, keep diagrams connected, export, reuse shapes and draft from text.

canvas-drawing-editorDraw and edit shapes, freehand strokes, text and images, with undo and redo, actions, shortcuts and object snapping.20files tagged
structured-diagrammingKeep diagrams connected when edited: arrow binding, elbow routing, flowchart creation, frames and spreadsheet-to-chart.11files tagged
scene-export-and-file-formatExport to PNG, SVG, clipboard and open .excalidraw JSON, with scene data embedded in images and restore of older files.12files tagged
shape-librariesReuse personal and community shapes, with install from allowed URLs, import and export, and publishing to the public catalog.5files tagged
ai-text-to-diagramTurn chat prompts and Mermaid definitions into editable diagrams, and wireframe frames into HTML, through a rate-limited AI backend.5files tagged

Each number counts files carrying that capability tag; it does not measure feature size. Also among the 10 recorded capabilities: embeddable-editor-sdk (next slide), live-collaboration-rooms and encrypted-share-links (slide 5), local-first-persistence, excalidraw-plus-bridge.

The answer: you can embed Excalidraw in a React app; check its 0.x API, App.tsx and hosted backends first.

What embedding involves

Embedding means rendering <Excalidraw /> in your React app, wiring its props and keeping data handling on your side.

Step 1

Install the package

@excalidraw/excalidraw comes from npm. The host app supplies React and React DOM.

Step 2

Load on the client

In a Next.js app, the recorded flow follows examples/with-nextjs.

Step 3

Wire the data

Pass initialData and read scene changes through the onChange prop.

Step 4

Go further

ExcalidrawImperativeAPI and UI overrides. Named surfaces include MainMenu and WelcomeScreen.

What comes with the package

  • Tagged entry files: index.tsx, types.ts, i18n.ts under packages/excalidraw.
  • Internal dependencies: @excalidraw/common, element, math, utils.
  • Next and latest release tags, locales via Crowdin, Docusaurus dev-docs.

What stays with your app (from the capability map, not verified)

  • Data handling is the host application's responsibility.
  • Bundle size and lazy chunks directly affect host app performance.
  • Translation coverage varies across the locale files, so some languages show partial text.

The answer: you can embed Excalidraw in a React app; check its 0.x API, App.tsx and hosted backends first.

How collaboration and sharing work

Rooms and share links encrypt in the browser and carry the key in the URL, so holding the link means holding access.

Live room

Encrypt in browser

AES-GCM broadcast of scene updates. Room id and key sit in the URL hash.

Relay over WebSockets

socket.io-client to oss-collab.excalidraw.com, with cursors and idle status.

Persist in Firebase

Firestore and Storage hold encrypted scenes and files.

Reconcile by version

Conflicts settle deterministically by element version. Tagged: data/reconcile.ts.

Share link

Compress, encrypt

A scene snapshot, in the browser, with AES-GCM and the Web Crypto API.

Upload ciphertext

Posted to json.excalidraw.com. Firebase Storage path: /files/shareLinks.

Key in the fragment

#json=id,key stays in the URL fragment, which browsers do not send to servers.

Decrypt on open

The recipient gets the decrypted scene loaded in their own browser.

Limits from the capability map, not verified

4 MiB

Image files over FILE_UPLOAD_MAX_BYTES cannot be uploaded to the room.

24 h

After this, deleted elements stop syncing; a returning client can reintroduce or miss deletions.

No revocation

exportToBackend exposes no revocation or expiry step for a shared link.

Link is key

A leaked room link grants full access; a lost one means the scene cannot be decrypted.

The answer: you can embed Excalidraw in a React app; check its 0.x API, App.tsx and hosted backends first.

Where the code carries weight and risk

The weight sits in App.tsx and scene compatibility; the risk sits in a 0.x API, open room rules and data outside the encryption.

From the capability map, not verified

One large classpackages/excalidraw/components/App.tsx is one very large class, so a change can have a wide blast radius.
Scene compatibilityChanges to element shape or store deltas can break restore of older scenes and collaboration between client versions. Restore must stay backward compatible with every published file version.
0.x APIAPI changes break host applications, and the package is still on 0.x versions.
Open room rulesfirestore.rules and storage.rules allow anonymous get and write, so anyone holding a room id can overwrite its ciphertext.
Outside the encryptionAI prompts, frame text and a frame image go to the AI backend outside end-to-end encryption. exportToExcalidrawPlus puts the key in a query parameter. Embed scene stores editable scene data in the exported file.

Counted by the scan

6

import cycles

654

type-only deps

750

external deps

This selection does not say where the cycles sit or tie them to App.tsx.

The answer: you can embed Excalidraw in a React app; check its 0.x API, App.tsx and hosted backends first.

What to check first

Check the API surface, the runtime cost, the backend boundary, the link model and scene restore before you commit.

1Pin the API you would depend onList the ExcalidrawProps and ExcalidrawImperativeAPI members you need. The package is on 0.x, with next and latest release tags.
2Measure runtime cost in your hostStart from examples/with-nextjs. Bundle size and lazy chunks affect the host app, and rendering cost grows with element count.
3Draw the backend boundaryCollaboration files are tagged in both excalidraw-app and packages/excalidraw; this selection does not say what the package brings. Decide on oss-collab, json and oss-ai.excalidraw.com.
4Review access rules and the link modelRead firebase-project/firestore.rules and storage.rules. Then test the recorded claims: anonymous writes, full access by link, no revocation through exportToBackend.
5Run your scenes through restoreExercise packages/excalidraw/data/restore.ts across a version change. Scenes saved by older versions can hold bindings that newer routing has to repair.

Not in this selection: a bundle size, an element-count limit or a license name. The risks named here come from the capability map and have not been verified.