Sharing & Collaboration
Share your JSON documents with others for real-time collaborative editing.
Sharing is the user-facing collaboration feature. For how sync works technically across tabs and devices, see Remote Sync.
Creating a share
- Click the Share button in the editor toolbar (requires sign-in)
- Configure permissions for the share
- Optionally set a passcode for protection
- Copy the generated share link
The share link looks like: https://forgejson.com/share/[shareId]
Permissions
When creating a share, you control what others can do:
| Permission | Description |
|---|---|
| Edit left panel | Collaborators can modify the left panel |
| Edit right panel | Collaborators can modify the right panel |
| Read only | Collaborators can view but not edit |
The share owner always has full edit access to both panels.
Real-time sync
Changes from any participant are synced to all others in real-time. The system uses a 1-second echo prevention window to avoid feedback loops — if you make a change, you won’t see it bounced back as an external update.
Presence
When multiple people have the share open, you can see who else is connected. Each participant’s presence is tracked with a 30-second heartbeat.
Presentation mode
The share owner can enter presentation mode, which makes all other participants follow the presenter’s view:
- The presenter’s scroll position is synced to followers
- The presenter’s active panel is mirrored
Collaborators can choose to stop following and browse independently.
Managing shares
From the editor:
- Transfer control — hand ownership to another participant
- Kick user — remove a participant from the session
- Delete share — permanently end the share session
Comments
Collaborators can leave comments on the shared document. Comments can be resolved (marked as done) by any participant.
Related
- Remote Sync — how sync works across tabs and devices
- Document Ownership — who can edit
- Core Concepts