Excalidraw for OpenCloud

An Excalidraw drawing application integrated as a native OpenCloud web extension. Create, edit and collaborate on .excalidraw drawings directly within OpenCloud.

Features

• Create new Excalidraw drawings from the "New" menu
• Open and edit existing .excalidraw files
• Auto-save support via OpenCloud's AppWrapperRoute
• Read-only mode for shared files
• Export drawings to various formats

Installation

1. Download the latest release archive from the Releases page.
2. Extract the archive into your OpenCloud web assets directory:

   unzip web-app-excalidraw.zip -d /var/lib/opencloud/web/assets/apps/excalidraw/

3. Restart OpenCloud to pick up the new extension.

Content Security Policy

Excalidraw loads fonts from esm.sh at runtime. You need to add https://esm.sh/ to the font-src CSP directive in your OpenCloud configuration:

# csp.yaml
directives:
  font-src:
    - "'self'"
    - "https://esm.sh/"

Without this, fonts will be blocked and Excalidraw will fall back to system fonts.

Development

Prerequisites

• Node.js >= 22
• pnpm (see packageManager field in package.json for the exact version)
• Docker and Docker Compose (for local dev server)

Setup

pnpm install
pnpm build:w

Local Development Server

docker compose up

Then open https://host.docker.internal:9200 (default credentials: admin/admin).

Build for Production

pnpm build

The production build is output to the dist/ directory.

Testing

pnpm test:unit

License

Apache-2.0