Skip to main content

Self-host

This covers the open-source SCAN reference whiteboard (apps/whiteboard in scan-js) — not the full Sphere product (auth, library, Ask Sphere).

Dev server​

git clone https://github.com/w2b-hq-app-cloud/scan-js.git
cd scan-js
npm install --legacy-peer-deps
npm run build
npm run dev

Production static build​

npm install --legacy-peer-deps
npm run build

Serve the whiteboard dist with any static file server (nginx, GitHub Pages, Cloudflare Pages, …).

Docker (optional)​

FROM node:22-alpine AS build
WORKDIR /app
COPY . .
RUN npm install --legacy-peer-deps && npm run build

FROM nginx:alpine
COPY --from=build /app/apps/whiteboard/dist /usr/share/nginx/html

Sphere product hosting​

The hosted Sphere product (accounts, Library, Ask Sphere) runs at a URL specific to your deployment. Self-hosting the proprietary app and its backend services is not covered in these public docs.