You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

History

Márk Tolmács b2a6a87b10 chore: Remove @tldraw/vec (#8762 ) Not needed.		3 months ago
..
actions	feat: image cropping (#8613 )	4 months ago
components	fix: Optimize frameToHighlight state change and snapLines state change (#8763 )	3 months ago
context	…
css	…
data	feat: export scene to e+ on workspace creation/redemption (#8514 )	3 months ago
element	fix: Unify binding update options for `updateBoundElements()` (#8832 )	3 months ago
fonts	chore: simplify line-break regexes, separate text wrapping (#8715 )	3 months ago
hooks	…
locales	feat: image cropping (#8613 )	4 months ago
renderer	fix: image cropping svg + compat mode (#8710 )	4 months ago
scene	fix: load font faces in Safari manually (#8693 )	3 months ago
subset	…
tests	fix: Unify binding update options for `updateBoundElements()` (#8832 )	3 months ago
.gitignore	…
.size-limit.json	…
CHANGELOG.md	…
README.md	…
align.ts	…
analytics.ts	…
animated-trail.ts	…
animation-frame-handler.ts	…
appState.ts	feat: image cropping (#8613 )	4 months ago
binaryheap.ts	…
change.ts	feat: image cropping (#8613 )	4 months ago
charts.test.ts	…
charts.ts	…
clients.ts	…
clipboard.test.ts	…
clipboard.ts	…
colors.ts	…
constants.ts	fix: load font faces in Safari manually (#8693 )	3 months ago
css.d.ts	…
cursor.ts	…
deburr.ts	…
distribute.ts	…
emitter.ts	…
env.cjs	…
errors.ts	feat: export scene to e+ on workspace creation/redemption (#8514 )	3 months ago
fractionalIndex.ts	…
frame.test.tsx	…
frame.ts	…
gesture.ts	…
global.d.ts	…
groups.ts	…
history.ts	…
i18n.ts	…
index-node.ts	…
index.tsx	…
jotai.ts	…
keys.test.ts	fix: undo/redo action for international keyboard layouts (#8649 )	4 months ago
keys.ts	fix: undo/redo action for international keyboard layouts (#8649 )	4 months ago
laser-trails.ts	…
mermaid.test.ts	…
mermaid.ts	…
package.json	chore: Remove @tldraw/vec (#8762 )	3 months ago
points.ts	…
polyfill.ts	…
pwacompat.d.ts	…
queue.test.ts	…
queue.ts	…
random.ts	…
react-app-env.d.ts	…
reactUtils.ts	…
shapes.tsx	…
snapping.ts	…
store.ts	feat: image cropping (#8613 )	4 months ago
tsconfig.json	…
types.ts	fix: restore svg image DataURL dimensions (#8730 )	4 months ago
utility-types.ts	…
utils.ts	…
visualdebug.ts	…
vite-env.d.ts	…
workers.ts	…
zindex.ts	…

README.md

Excalidraw

Excalidraw is exported as a component to directly embed in your projects.

Installation

You can use npm

npm install react react-dom @excalidraw/excalidraw

or via yarn

yarn add react react-dom @excalidraw/excalidraw

After installation you will see a folder excalidraw-assets and excalidraw-assets-dev in dist directory which contains the assets needed for this app in prod and dev mode respectively.

Move the folder excalidraw-assets and excalidraw-assets-dev to the path where your assets are served.

By default it will try to load the files from https://unpkg.com/@excalidraw/excalidraw/dist/

If you want to load assets from a different path you can set a variable window.EXCALIDRAW_ASSET_PATH depending on environment (for example if you have different URL's for dev and prod) to the url from where you want to load the assets.

Note

If you don't want to wait for the next stable release and try out the unreleased changes you can use @excalidraw/excalidraw@next.

Dimensions of Excalidraw

Excalidraw takes 100% of width and height of the containing block so make sure the container in which you render Excalidraw has non zero dimensions.

Demo

Try here.

Integration

Head over to the docs

API

Head over to the docs

Contributing

Head over to the docs