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

Excalidraw Bot 836c8f2dba New translations en.json (Bengali)		2 months ago
..
actions	feat: add system mode to the theme selector (#7853 )	10 months ago
components	fix: hit test for closed sharp curves (#7881 )	10 months ago
context	…
css	feat: expose more collaborator status icons (#7777 )	11 months ago
data	fix: parse embeddable srcdoc urls strictly (#7884 )	10 months ago
element	fix: allow same origin for all necessary domains (#7889 )	10 months ago
hooks	feat: add system mode to the theme selector (#7853 )	10 months ago
locales	New translations en.json (Bengali)	2 months ago
renderer	fix: always make sure we render bound text above containers (#7880 )	10 months ago
scene	feat: add system mode to the theme selector (#7853 )	10 months ago
tests	feat: fractional indexing (#7359 )	10 months ago
.gitignore	…
.size-limit.json	…
CHANGELOG.md	feat: add system mode to the theme selector (#7853 )	10 months ago
README.md	…
align.ts	…
analytics.ts	fix: command palette tweaks and fixes (#7876 )	10 months ago
animated-trail.ts	…
animation-frame-handler.ts	…
appState.ts	fix: remove t from getDefaultAppState and allow name to be nullable (#7666 )	12 months ago
charts.test.ts	…
charts.ts	…
clients.ts	feat: expose more collaborator status icons (#7777 )	11 months ago
clipboard.test.ts	…
clipboard.ts	fix: remove dependency of t from clipboard and image (#7712 )	12 months ago
colors.ts	…
constants.ts	feat: fractional indexing (#7359 )	10 months ago
css.d.ts	…
cursor.ts	…
deburr.ts	feat: command palette (#7804 )	11 months ago
distribute.ts	…
emitter.ts	…
env.cjs	…
errors.ts	feat: fractional indexing (#7359 )	10 months ago
fractionalIndex.ts	feat: fractional indexing (#7359 )	10 months ago
frame.test.tsx	…
frame.ts	feat: fractional indexing (#7359 )	10 months ago
ga.ts	…
gadirections.ts	…
galines.ts	…
gapoints.ts	…
gatransforms.ts	…
gesture.ts	…
global.d.ts	…
groups.ts	…
history.ts	…
i18n.ts	…
index-node.ts	…
index.tsx	feat: support to not render remote cursor & username (#7130 )	11 months ago
jotai.ts	…
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	…
math.ts	…
package.json	feat: fractional indexing (#7359 )	10 months ago
points.ts	…
polyfill.ts	…
pwacompat.d.ts	…
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	…
react-app-env.d.ts	…
reactUtils.ts	…
shapes.tsx	…
snapping.ts	fix: make bounds independent of scene (#7679 )	12 months ago
tsconfig.json	…
types.ts	feat: fractional indexing (#7359 )	10 months ago
utility-types.ts	feat: store library to IndexedDB & support storage adapters (#7655 )	11 months ago
utils.ts	fix: add safe check for arrow points length in tranformToExcalidrawElements (#7863 )	10 months ago
vite-env.d.ts	…
zindex.ts	feat: fractional indexing (#7359 )	10 months 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