Real-time collaboration
Several people can edit the same text document or spreadsheet at the same time. Edits appear for everyone within a second, you see who is there and where they are working, and anyone can save and restore versions.
Starting a session
- Open or create a document, then click 👥 (Collaborate) in the toolbar.
- Send the invitation to the people you want to work with. The invitation window offers several ways:
- the QR code: scan it with a phone or tablet camera;
- Show full screen: a large QR code to scan from across a room, for example on a classroom projector;
- Copy the link, to paste it in a message, a chat or a course page;
- Share…: the system share sheet (messages, mail, AirDrop, Nearby Share…), on devices that have one;
- Email: a ready-to-send email with the link;
- Send with QRShare: opens the link in QRShare, which can show it as a QR code, send it to devices nearby on the same network, or transfer it without any network.
A bar appears above the document with the people in the session, an Invite button to show the link again, Versions, and Leave.
Joining
Open the invitation link. Progressive Web Office opens a new document and fills it with the shared content as soon as another participant is online. The link stays in the address bar: reloading the page rejoins the session.
On another device, scan the QR code of the invitation, for example with Receive from another device…: QRShare recognises a static QR code (the link) as well as animated ones.
When nobody comes
The bar says where the connection is:
- Looking for the others…: the relays are reached, nobody else is there yet;
- Waiting for the shared document…: someone is there, the document is coming;
- Cannot reach the servers used to find each other: no Internet, a network that blocks the relays, or relays that refuse the messages.
By default, several well-known public Nostr relays are used at once, so that one relay down or refusing messages does not keep the participants apart.
When nobody can be reached directly for 15 seconds — browsers that cannot connect to each other, typically a company network on one side and mobile data on the other — the session also goes through the relays: the messages are encrypted with the secret of the invitation (the relays see neither the room nor the content), cut into small pieces and passed on without being kept. The bar then says Connected through the relays (slower). A TURN server makes such connections direct again, and faster.
After 20 seconds without anyone, it explains what to check: the other person must have the page of the link open; some networks (company, school, mobile data) block direct connections between browsers — try the same Wi-Fi network, or set a TURN server in Settings › Collaboration, where you can also set your own relays. Without a network, use synchronisation without a network.
Participants introduce themselves when they meet (application, protocol version, kind of document): if another app or another version joins, the bar warns that its changes are not trusted — reload the page on both sides.
Who is here
Each participant gets a friendly name such as Swift Crimson Falcon, written in the colour of its colour word. Click your own name in the bar to change it (it is remembered on this device).
- In a spreadsheet, the cell each person has selected is outlined in their colour, with their name.
- In a text document, the paragraph each person is in is marked in the margin.
How edits merge
- Spreadsheets: each cell is merged separately. Two people typing in different cells never overwrite each other; if both change the same cell at the same moment, everyone ends up with the same one of the two values.
- Text documents: each paragraph is merged separately. Edits in different paragraphs are all kept; if two people change the same paragraph at the same moment, one version of that paragraph wins, the same for everyone. Your caret stays in place when others' edits arrive.
Undo history is reset when someone else changes a spreadsheet, so that undoing never brings back a state that would erase their work.
Versions
Versions opens the shared history:
- Save version records the current state under a name, with your name and the date. Everyone in the session gets it, including people who join later.
- Restore brings the document back to a version for everyone. The current state is first saved as a version ("Before restoring…"), so a restore can itself be undone.
Privacy and how it works
- No server stores your document. It travels directly between the browsers (WebRTC), end-to-end encrypted.
- To find each other, browsers exchange connection details through public Nostr relays, encrypted with the secret contained in the link. The relays never see the document.
- Anyone with the link can join and edit. Share it only with the people you want to work with. To stop, everyone clicks Leave; start a new session to get a new link.
- Each participant keeps the document and its history on their own device (browser storage), so the session continues even if the person who started it is offline — as long as at least one participant is online when another joins.
- Saving still works as usual: any participant can save the document as a file, to the cloud or to a git repository at any time.
Firewalls that block peer-to-peer connections (some corporate or school networks) can prevent participants from connecting.
Compatibility
The collaboration engine is the @scelles/collab package, shared with QRShare's collaborative editor: same protocol, same history format.
Presentations, comments and suggested changes are not available yet.