Drawy Self hostable Collaborative Whiteboard

Drawy, a multi tenant capable with real time collaboration and version history. Covers setup, self hosting on Cloudflare Workers, and architecture.

Drawy is a collaborative drawing workspace built on Excalidraw. It gives you the full Excalidraw editor — infinite canvas, shapes, arrows, freehand, frames, images — plus the collaboration features most teams need: live cursors, shared canvases, version history, and reusable libraries. Everything runs on your infrastructure.

Quick Start (5 Minutes)

1. Create an Account

No email required. Just a username and password.

# Open the hosted version
open https://drawy.pratyay.online/login

# Or self-host (see Self-Hosting section below)

2. Start a canvas

Click New canvas in the sidebar. Canvases group by last-edit date so recent work stays visible.

Drawy autosaves as you draw. After a short pause the header shows Saved. The Save Button in the editor header forces an immediate save.

3. Share & collaborate

Open Share canvas to choose access:

OptionWho can openBest for
Private (default)Only youWork in progress
Invite by usernameSpecific Drawy userEditing together in real time
Read-only linkAnyone with the linkPublishing finished drawings, collecting feedback

Revoke access anytime without deleting the canvas.


Core Features

Real-time collaboration

Multiple people edit the same canvas simultaneously. Live cursors, selections, and strokes appear as they happen — point at a shape instead of describing it.

Powered by Cloudflare’s Durable Objects. The worker relays updates between users.

Version history

Drawy keeps the 50 most recent snapshots per canvas. Open version history → click a snapshot → one-click rollback.

Libraries

Reusable shape collections (icons, diagram pieces, UI mockups) that work across canvases.

Self Hosting Drawy

Drawy has three components: front end (TanStack Start), real time worker (Cloudflare Durable Objects), and data store (Postgres). All deploy together via wrangler deploy.

Prerequisites

1. Clone & install

git clone https://github.com/Pratyay360/drawy.git
cd drawy
mise deps

2. Configure environment

VariableRequiredPurpose
DATABASE_URLyesPostgres connection string (pooled URL preferred)
SESSION_SECRETyesSigns session cookie — openssl rand -hex 32
VITE_SITE_URLnoCanonical app URL (defaults to https://drawyparty.pratyay.online)
SENTRY_AUTH_TOKENnoUploads source maps during build (optional)

Copy .env.example to .env and fill in values.

3. Create database tables

bun run db:generate
bun run db:migrate
bun run db:push

Applies src/lib/db/schema.ts → creates app_users, canvases, canvas_versions.

4. Run locally

bun run dev          # Frontend on http://localhost:3000
bun run cf:dev       # Built worker on http://localhost:8787 (app + rooms)

5. Deploy to Cloudflare Workers

bun run build              # Writes .output/server and .output/public
bun run deploy:dry-run     # Packages worker without uploading
bun run deploy             # Builds and uploads to Cloudflare

wrangler.jsonc is the single source of truth for worker config: name, compatibility date/flags, ASSETS binding, Main/Rooms Durable Object bindings.

Secrets (set in Cloudflare dashboard or via CLI):

bunx wrangler secret put DATABASE_URL
bunx wrangler secret put SESSION_SECRET

Operational notes:


Architecture (for developers)

LayerTechnologyRole
Canvas & editorExcalidrawDrawing surface, tools, element model
App shell & routingTanStack Start + RouterApplication framework & routes
APIoRPCTyped API between client & server
RealtimePartyServer on Cloudflare Durable ObjectsPresence & Yjs sync for live collaboration
StoragePostgres via Drizzle ORMPersistent canvas storage
UIAstryxComponent library & theming

Data flow:

  1. Client renders Excalidraw inside TanStack Start app
  2. Live cursors/selections/strokes sync via Cloudflare Durable Objects
  3. Canvases persist to Postgres → enables autosave + version history

Privacy & Security

What Drawy Stores

What Drawy does NOT store

Images

Pasted/uploaded images may go to an external host (imgbb.com by default). The saved URL stays with the canvas. Once uploaded, the image lives on that host.

Sessions & error tracking

May use Sentry (when enabled) for error tracking — collects technical details per its own policy.

Data removal

Comments