Install

:::info Requires React 19 Apollon renders on React 19 (react / react-dom ^19). On React 18 the install fails with an ERESOLVE peer error — upgrade your host to React 19 first. :::

React hosts

You already have react and react-dom — add the remaining peers:

npm install @tumaet/apollon @xyflow/react yjs y-protocols

import { Apollon } from "@tumaet/apollon"
import "@tumaet/apollon/style.css"

The <Apollon> component, hooks, and provider render on the React you already have — see React.

Non-React hosts (Angular, Vue, Svelte, vanilla)

Install all five peers. The API is imperative — new ApollonEditor(container, options) — and the editor renders its own React tree inside the container, so your own code never imports React:

npm install @tumaet/apollon \
  react react-dom \
  @xyflow/react \
  yjs y-protocols

import { ApollonEditor } from "@tumaet/apollon"
import "@tumaet/apollon/style.css"

Peer dependencies

Peer	Range	Powers
react	^19.0.0	the editor's rendering
react-dom	^19.0.0	the editor's rendering
@xyflow/react	^12.9.0	the diagram canvas
yjs	^13.6.0	the document model, undo/redo, and live collaboration
y-protocols	^1.0.6	collaboration sync/awareness

npm 7+ auto-installs missing peers; pnpm and yarn users add them explicitly. Apollon externalizes every runtime dependency, so a host that already uses React or Yjs shares a single instance with the editor instead of a private, possibly mismatched copy — no duplicate payload, and no "Invalid hook call" or cross-instance-document errors.

Optional: PNG / PDF export

SVG and JSON export are built in. For PNG and PDF, install the optional renderers and import them from @tumaet/apollon/export:

npm install @resvg/resvg-wasm jspdf svg2pdf.js

See Export for usage and the per-bundler wasm setup (PNG needs the resvg wasm; PDF needs nothing extra).

No bundler (CDN)

On the CDN path, esm.sh resolves and serves the peers from the import URL automatically — there is nothing extra to load. See Vanilla JS / CDN.

Type definitions

Types ship with the package (dist/index.d.ts). Requires TypeScript 5.0+ with moduleResolution: "bundler" | "node16" | "nodenext".