Collaboration
Orimora supports real-time collaborative editing — multiple people can edit the same document simultaneously, see who is online, leave comments, and browse revision history.
How it works
Section titled “How it works”Collaboration uses Yjs over a WebSocket connection to path /collab on the same origin as the app (e.g. wss://orimora.com/collab).
- Changes sync in near real time between all open editors
- Each user’s cursor and selection appear with a color-coded label
- The document persists to PostgreSQL when editing pauses or on disconnect
Presence avatars
Section titled “Presence avatars”When others are editing the same document, avatar chips appear in the document meta bar showing who is active. Hover for names; a “+N more” indicator appears when many users are present.
You do not need to configure anything for presence — it activates automatically when a document has a collaborative session.
Comments
Section titled “Comments”- Select text in the editor
- Click Add comment in the bubble menu
- The Comments panel opens — write your message and submit
Comments are anchored to the selected text. Click a comment highlight in the document to jump to the thread in the panel.
Team members with the Delete Any Comment capability can remove others’ comments (see Permissions).
Revision history
Section titled “Revision history”Open History from the document panels menu.
- Revisions are saved automatically as you edit
- Click any snapshot to compare with the current version
- Restore rolls the document back to that snapshot (creates a new revision)
- Delete individual snapshots if you have edit rights
Restoring does not affect other users’ unsaved collab state immediately — coordinate with your team before restoring on active documents.
Server configuration
Section titled “Server configuration”| Variable | Purpose | Default |
|---|---|---|
COLLAB_SECRET | Optional shared secret for the collab endpoint | unset |
COLLAB_MAX_CONNECTIONS | Max simultaneous WebSocket connections | 50 |
COLLAB_MAX_YJS_STATE_BYTES | Max document state size (anti-abuse) | 8 MB |
EXTRA_ALLOWED_ORIGINS | Additional allowed origins if app is accessed via multiple domains | — |
Set EXTRA_ALLOWED_ORIGINS when users reach the app through a staging domain or alternate hostname that shares the same backend.
Troubleshooting
Section titled “Troubleshooting”| Symptom | What to check |
|---|---|
| Edits do not sync | WebSocket blocked? Browser dev tools → Network → WS to /collab |
| ”Disconnected” banner | Network drop — refresh; check reverse proxy WS timeout |
| Collab works on desktop but not mobile | Same origin required; no mixed HTTP/HTTPS |
| Rate limits on login affect everyone behind proxy | Set ADDRESS_HEADER and XFF_DEPTH — see Coolify Setup |
See also
Section titled “See also”- Editor — writing, slash commands, panels
- Permissions & groups — who can edit which collections
- Configuration —
COLLAB_*andEXTRA_ALLOWED_ORIGINS