Skip to content

Virtual whiteboard for sketching hand-drawn like diagrams

build(webpack): remove publicPath so __webpack_public_path__ can be used to host assets (#2835)

Aakansha Doshi0b2e4dd60bbb
diff --git a/src/packages/excalidraw/CHANGELOG.md b/src/packages/excalidraw/CHANGELOG.md
index 298eeee8e3..c13522db45 100644
--- a/src/packages/excalidraw/CHANGELOG.md
+++ b/src/packages/excalidraw/CHANGELOG.md
@@ -23,6 +23,10 @@ Please add the latest change on the top under the correct section.
- Add `viewModeEnabled` prop which enabled the view mode [#2840](https://github.com/excalidraw/excalidraw/pull/2840). When this prop is used, the view mode will not show up in context menu is so it is fully controlled by host.
- Expose `getAppState` on `excalidrawRef` [#2834](https://github.com/excalidraw/excalidraw/pull/2834).
+### Build
+
+- Remove publicPath so host can use `__webpack_public_path__` to host the assets[#2835](https://github.com/excalidraw/excalidraw/pull/2835)
+
## Excalidraw Library
### Features
diff --git a/src/packages/excalidraw/README.md b/src/packages/excalidraw/README.md
index 1cb208ba60..74d935e045 100644
--- a/src/packages/excalidraw/README.md
+++ b/src/packages/excalidraw/README.md
@@ -18,7 +18,15 @@ yarn add react react-dom @excalidraw/excalidraw
After installation you will see a folder `excalidraw-assets` in `dist` directory which contains the assets needed for this app.
-Move the folder `excalidraw-assets` to the path where your assets are served. In the example its served from `public/excalidraw-assets`
+Move the folder `excalidraw-assets` to the path where your assets are served.
+
+By default it will try to load the files from `{rootUrl}/excalidraw-assets/`
+
+With **Webpack**, if you want to load the files from different path you can use <pre><a href="https://webpack.js.org/guides/public-path/#on-the-fly">`__webpack_public_path__`</a></pre>.
+
+With **create-react-app**, the assets can be served from `public/static/js/excalidraw-assets`since CRA tries to load the assets from `{rootUrl}/static/js` path by default.
+
+You can update the value of `PUBLIC_URL` if you want to serve it from a different URL.
### Demo
@@ -26,6 +34,8 @@ Move the folder `excalidraw-assets` to the path where your assets are served. In
### Usage
+1. If you are using a Web bundler (for instance, Webpack), you can import it as an ES6 module as shown below
+
```js
import React, { useEffect, useState, createRef } from "react";
import Excalidraw from "@excalidraw/excalidraw";
@@ -119,6 +129,55 @@ export default function App() {
[![Edit excalidraw](https://codesandbox.io/static/img/play-codesandbox.svg)](https://codesandbox.io/s/excalidraw-ehlz3?fontsize=14&hidenavigation=1&theme=dark)
+2. To use it in a browser directly:
+
+You will need to make sure `react`, `react-dom` is available as shown below.
+
+```html
+<!DOCTYPE html>
+<html>
+ <head>
+ <title>Excalidraw in browser</title>
+ <meta charset="UTF-8" />
+ <script src="https://unpkg.com/[email protected]/umd/react.development.js"></script>
+ <script src="https://unpkg.com/[email protected]/umd/react-dom.development.js"></script>
+ <script
+ type="text/javascript"
+ src="https://unpkg.com/@excalidraw/[email protected]/dist/excalidraw.min.js"
+ ></script>
+ </head>
+
+ <body>
+ <div class="container">
+ <h4>Excalidraw Embed Example</h4>
+ <div id="app"></div>
+ </div>
+
+ <script type="text/javascript" src="src/index.js"></script>
+ </body>
+</html>
+```
+
+```js
+import "./styles.css";
+
+const excalidrawWrapper = document.getElementById("app");
+
+const props = {
+ onChange: (data, appState) => {
+ console.log(data, appState);
+ },
+};
+
+/*eslint-disable */
+ReactDOM.render(
+ React.createElement(Excalidraw.default, props),
+ excalidrawWrapper,
+);
+```
+
+[![Edit excalidraw-in-browser](https://codesandbox.io/static/img/play-codesandbox.svg)](https://codesandbox.io/s/excalidraw-in-browser-tlqom?fontsize=14&hidenavigation=1&theme=dark)
+
### Props
| Name | Type | Default | Description |
diff --git a/src/packages/excalidraw/webpack.prod.config.js b/src/packages/excalidraw/webpack.prod.config.js
index 434c205992..d15ec15995 100644
--- a/src/packages/excalidraw/webpack.prod.config.js
+++ b/src/packages/excalidraw/webpack.prod.config.js
@@ -13,7 +13,6 @@ module.exports = {
library: "Excalidraw",
libraryTarget: "umd",
filename: "[name].js",
- publicPath: "/",
chunkFilename: "excalidraw-assets/[name].js",
},
resolve: {