# Integration ## Module bundler If you are using a module bundler (for instance, Webpack), you can import it as an ES6 module as shown below ```js import { Excalidraw } from "@excalidraw/excalidraw"; ``` :::info Throughout the documentation we use live, editable Excalidraw examples like the one shown below. While we aim for the examples to closely reflect what you'd get if you rendered it yourself, we actually initialize it with some props behind the scenes. For example, we're passing a `theme` prop to it based on the current color theme of the docs you're just reading. ::: ```jsx live function App() { return ( <>

Excalidraw Example

); } ``` ### Next.js Since _Excalidraw_ doesn't support server side rendering, you should render the component once the host is `mounted`. Here are two ways on how you can render **Excalidraw** on **Next.js**. 1. Using **Next.js Dynamic** import [Recommended]. Since Excalidraw doesn't support server side rendering so you can also use `dynamic import` to render by setting `ssr` to `false`. ```jsx showLineNumbers import dynamic from "next/dynamic"; const Excalidraw = dynamic( async () => (await import("@excalidraw/excalidraw")).Excalidraw, { ssr: false, }, ); export default function App() { return ; } ``` Here is a working [demo](https://codesandbox.io/p/sandbox/excalidraw-with-next-dynamic-k8yjq2). 2. Importing Excalidraw once **client** is rendered. ```jsx showLineNumbers import { useState, useEffect } from "react"; export default function App() { const [Excalidraw, setExcalidraw] = useState(null); useEffect(() => { import("@excalidraw/excalidraw").then((comp) => setExcalidraw(comp.Excalidraw), ); }, []); return <>{Excalidraw && }; } ``` Here is a working [demo](https://codesandbox.io/p/sandbox/excalidraw-with-next-5xb3d) The `types` are available at `@excalidraw/excalidraw/types`, you can view [example for typescript](https://codesandbox.io/s/excalidraw-types-9h2dm) ### Preact Since we support `umd` build ships with `react/jsx-runtime` and `react-dom/client` inlined with the package. This conflicts with `Preact` and hence the build doesn't work directly with `Preact`. However we have shipped a separate build for `Preact` so if you are using `Preact` you need to set `process.env.IS_PREACT` to `true` to use the `Preact` build. Once the above `env` variable is set, you will be able to use the package in `Preact` as well. :::info When using `vite` or any build tools, you will have to make sure the `process` is accessible as we are accessing `process.env.IS_PREACT` to decide whether to use `preact` build. Since Vite removes env variables by default, you can update the vite config to ensure its available :point_down: ``` define: { "process.env.IS_PREACT": JSON.stringify("true"), }, ``` ::: ## Browser To use it in a browser directly: For development use :point_down: ```js ``` For production use :point_down: ```js ``` You will need to make sure `react`, `react-dom` is available as shown in the below example. For prod please use the production versions of `react`, `react-dom`. import Tabs from "@theme/Tabs"; import TabItem from "@theme/TabItem"; ```html Excalidraw in browser

Excalidraw Embed Example

```
```js showLineNumbers const App = () => { return React.createElement( React.Fragment, null, React.createElement( "div", { style: { height: "500px" }, }, React.createElement(ExcalidrawLib.Excalidraw), ), ); }; const excalidrawWrapper = document.getElementById("app"); const root = ReactDOM.createRoot(excalidrawWrapper); root.render(React.createElement(App)); ```