ORGII Collaboration Hub

Self-deployable Cloudflare relay for ORGII collaboration orgs. It stores org metadata, members, invites, lightweight session metadata, and group chat messages, then relays live JSON updates through Durable Object WebSockets.

Who needs this?

Only one admin per ORGII collaboration org needs to deploy a hub. Teammates who join an existing org do not need npm, Cloudflare, Wrangler, or repo access; they only need the invite link generated by ORGII.

Create a hub project

npx @orgii/collab-hub init my-orgii-hub
cd my-orgii-hub
npm install

Deploy to Cloudflare

Log in to Cloudflare. The generated project uses npx wrangler@latest in its scripts so Wrangler does not need to be installed into the project dependencies.

npx wrangler@latest login

Create the D1 database:

npm run db:create

Cloudflare prints a database_id. Paste that value into wrangler.jsonc under d1_databases[0].database_id.

Apply migrations:

npm run db:migrate

Deploy the Worker:

npm run deploy

Wrangler prints the Worker URL, for example:

https://my-orgii-hub.example.workers.dev

Paste that URL into ORGII under Add Org → Create Org → Cloudflare hub URL.

Invite teammates

After creating the org in ORGII, copy the generated invite link and send it to teammates. The invite link includes the hub URL and invite code, so teammates do not need to configure Cloudflare.

Local development

npm run dev
npm run typecheck

Source repo workflow

Developers building ORGII from source can also work directly from the cloudflare/collab-hub folder in the ORGII repository. The npm package exists so bundled-app users can deploy the hub without cloning the app repo.