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

Ryan Di bbdcd30a73 refactor: update collision from ga to vector geometry (#7636 ) * new collision api * isPointOnShape * removed redundant code * new collision methods in app * curve shape takes starting point * clean up geometry * curve rotation * freedraw * inside curve * improve ellipse inside check * ellipse distance func * curve inside * include frame name bounds * replace previous private methods for getting elements at x,y * arrow bound text hit detection * keep iframes on top * remove dependence on old collision methods from app * remove old collision functions * move some hit functions outside of app * code refactor * type * text collision from inside * fix context menu test * highest z-index collision * fix 1px away binding test * strictly less * remove unused imports * lint * 'ignore' resize flipping test * more lint fix * skip 'flips while resizing' test * more test * fix merge errors * fix selection in resize test * added a bit more comment --------- Co-authored-by: dwelle <5153846+dwelle@users.noreply.github.com>		10 months ago
..
actions	refactor: update collision from ga to vector geometry (#7636 )	10 months ago
components	refactor: update collision from ga to vector geometry (#7636 )	10 months ago
context	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
css	feat: expose more collaborator status icons (#7777 )	11 months ago
data	feat: load old library if migration fails	11 months ago
element	refactor: update collision from ga to vector geometry (#7636 )	10 months ago
hooks	feat: command palette (#7804 )	11 months ago
locales	feat: show firefox-compatible command palette shortcut alias (#7825 )	11 months ago
renderer	refactor: update collision from ga to vector geometry (#7636 )	10 months ago
scene	feat: expose more collaborator status icons (#7777 )	11 months ago
tests	refactor: update collision from ga to vector geometry (#7636 )	10 months ago
.gitignore	docs: add next js with app router example (#7552 )	1 year ago
.size-limit.json	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
CHANGELOG.md	feat: store library to IndexedDB & support storage adapters (#7655 )	11 months ago
README.md	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
align.ts	fix: make getBoundTextElement and related helpers pure (#7601 )	1 year ago
analytics.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
animated-trail.ts	feat: add eraser tool trail (#7511 )	1 year ago
animation-frame-handler.ts	feat: add eraser tool trail (#7511 )	1 year ago
appState.ts	fix: remove t from getDefaultAppState and allow name to be nullable (#7666 )	12 months ago
charts.test.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
charts.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
clients.ts	feat: expose more collaborator status icons (#7777 )	11 months ago
clipboard.test.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
clipboard.ts	fix: remove dependency of t from clipboard and image (#7712 )	12 months ago
colors.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
constants.ts	feat: support to not render remote cursor & username (#7130 )	11 months ago
css.d.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
cursor.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
deburr.ts	feat: command palette (#7804 )	11 months ago
distribute.ts	fix: make getBoundTextElement and related helpers pure (#7601 )	1 year ago
emitter.ts	feat: support pen erasing (#7496 )	1 year ago
env.cjs	build: Welcome ESM and Bye Bye UMD (#7441 )	1 year ago
errors.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
frame.test.tsx	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
frame.ts	fix: export utils from excalidraw package in excalidraw library (#7731 )	12 months ago
ga.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
gadirections.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
galines.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
gapoints.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
gatransforms.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
gesture.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
global.d.ts	refactor: editor events sub/unsub refactor (#7483 )	1 year ago
groups.ts	fix: make getBoundTextElement and related helpers pure (#7601 )	1 year ago
history.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
i18n.ts	build: Welcome ESM and Bye Bye UMD (#7441 )	1 year ago
index-node.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
index.tsx	feat: support to not render remote cursor & username (#7130 )	11 months ago
jotai.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
keys.ts	feat: command palette (#7804 )	11 months ago
laser-trails.ts	feat: support to not render remote cursor & username (#7130 )	11 months ago
math.test.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
math.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
package.json	feat: command palette (#7804 )	11 months ago
points.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
polyfill.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
pwacompat.d.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
queue.test.ts	feat: store library to IndexedDB & support storage adapters (#7655 )	11 months ago
queue.ts	feat: store library to IndexedDB & support storage adapters (#7655 )	11 months ago
random.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
react-app-env.d.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
reactUtils.ts	fix: decouple react and react-dom imports from utils and make it treeshakeable (#7527 )	1 year ago
shapes.tsx	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
snapping.ts	fix: make bounds independent of scene (#7679 )	12 months ago
tsconfig.json	docs: add next js with app router example (#7552 )	1 year ago
types.ts	refactor: update collision from ga to vector geometry (#7636 )	10 months ago
utility-types.ts	feat: store library to IndexedDB & support storage adapters (#7655 )	11 months ago
utils.ts	feat: expose more collaborator status icons (#7777 )	11 months ago
vite-env.d.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago
zindex.ts	build: decouple package deps and introduce yarn workspaces (#7415 )	1 year ago

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