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