Managing a Shared Board

Everything about a shared board lives in one place: the Collaboration panel, opened with the Collaborate button in the top bar while the board is open.

The Collaboration panel of a shared board

Reading the panel

  • Connection stripConnected or Reconnecting…, your role on this board (owner, editor or viewer), the sequence number of the last change applied, and N queued if edits or uploads are still waiting to be sent.
  • People — every member with their role and whether they’re online right now.
  • Invite people — owners only; see Inviting and Joining.
  • Conflicts — appears only when something needs a decision; see Resolving Conflicts.
  • Room worker row — owners only: the version of the room service running in your Cloudflare account, whether an update is available, and the Update worker button.
  • Footer — the room’s address, Copy diagnostics, and Detach as local copy.

Updating the room service

The room service is a small program running in your Cloudflare account. When an app update ships a newer one, the owner’s panel says update available next to the room worker version.

  1. Click Update worker, then confirm Really update? Live sessions reconnect.
  2. The app redeploys the service using the Cloudflare API token it remembered during setup. If this machine has no remembered token (setups from before tokens were remembered), a field appears — paste the same token you created for setup.
  3. Everything durable survives: rooms, members, invites, sessions and media. Anyone connected drops for a moment, reconnects automatically and replays whatever they missed.

Do this soon after updating the app. If the room service falls too far behind the app, the panel reports update your collaboration worker and sync pauses — the board keeps working locally — until the owner runs the update.

Copy diagnostics

Copy diagnostics puts a support report on your clipboard: connection state, queue counts, recent errors and events from the sync engine. It never contains your access tokens or Cloudflare credentials. Paste it into a support message when something behaves unexpectedly.

Detaching as a local copy

Detach as local copy turns your copy of the board back into an ordinary local board. Click it, then confirm Really detach as local copy?

  1. Every media file the board references in cloud storage is downloaded into the board’s own media folder, and the cards are rewritten to use those local files — so the copy is genuinely independent.
  2. Only then does the board stop syncing. Nothing is deleted, locally or in the room.

If some file can’t be downloaded (no connection, for instance), detach stops with a message and nothing has changed — try again once you’re online; everything already downloaded is reused.

After detaching:

  • the board keeps working exactly as before, without presence or sync;
  • the other members keep their copies and, for as long as the room exists, keep collaborating among themselves;
  • you can now delete the board, import archives into it, or move cards between it and other boards;
  • a spent PRO shared-board slot is not refunded — see Plans, Limits and Costs.

To share the board again later, run Set up collaboration on it once more; it becomes a new room with new invites.

Deleting a shared board

Deleting is refused while a board is shared — detach it as a local copy first. Detach, then delete as usual.

Your Cloudflare account

Everything a shared board needs sits in your own account, where you can inspect or remove it at any time from the Cloudflare dashboard:

WhereWhat
Workers & Pages → moodboard-collabThe room service. Each shared board is one room (a SQLite Durable Object) holding its cards and arrows, members, invites, sessions and an audit log of who was invited and joined.
R2 → moodboard-shares, under collab/<board>/assets/Shared media, stored once per unique file. Deleted media is swept automatically after a safety window.
Daily snapshots in the same bucketEach room saves a snapshot of itself once a day and keeps the last five, so an accidentally emptied room can be restored.

Some safeguards run in the room itself: a client sending more than 60 operations in 10 seconds (a runaway script, for example) is throttled rather than allowed to burn through your Cloudflare quota, and every membership change is logged.

Deleting the moodboard-collab Worker ends every room hosted on it, and deleting the bucket removes the shared media. Ask collaborators to detach first, so their copies download the media they need while it still exists.

Where to go next

Was this helpful?

0

Updated

Comments

Leave a Reply

Your email address will not be published. Required fields are marked *