Co-op
How collaborative planning works inside the planner.
Co-op lets multiple people work in the same factory plan live. It is part of the planner, not a separate publish flow.
How co-op starts
Open the collaboration button in the planner header to create an invite link. That link opens the planner with an invite parameter and shows a join dialog for the invited user.
Joining through an invite adds that user as a collaborator on the factory. The default invite role is Editor.
If the invite token is invalid or expired, the join dialog shows an error instead of opening the factory.
Roles in co-op
Co-op uses three roles:
| Role | What it means |
|---|---|
Owner | Owns the factory, can manage invite links, change collaborator roles, and remove collaborators. |
Editor | Can open the shared factory and edit it. |
Viewer | Can open the shared factory but cannot edit it. |
A viewer can join the live session and watch other people work. The planner shows a viewer banner and blocks editing actions.
What you see in the planner
Co-op adds a few planner-specific signals:
- a collaboration button in the header
- stacked participant avatars when multiple people are present
- a status card that shows
Co-op ReadyorCo-op Active - remote cursors with participant names
- a drag indicator when another user is moving nodes
Co-op Ready means the connection is live but no second collaborator is in the room. Co-op Active means at least two participants are present in the same factory.
The status card can also show connection states like Connecting..., Reconnecting..., and Live.
What changes during a live session
Once co-op is active, planner changes are synchronized through the live session.
The most important rule is simple: Undo and Redo are blocked during live collaboration. The planner shows a banner for that instead of letting local history drift away from the shared state.
Live cursor updates and drag presence are separate from graph changes. That is why you can see where another user is working even before you inspect the node changes themselves.
Invite links and collaborator management
The collaboration panel has two management areas:
Invite Link: generate, copy, or revoke the active invite linkCollaborators: see who has access, whether they are online, and what role they have
Owners can change a collaborator between Editor and Viewer. Owners can also remove collaborators.
A collaborator can leave a shared factory from the Shared with me area.
Co-op vs publish
These two features solve different problems:
| Co-op | Publish | |
|---|---|---|
| Purpose | Work together live in the planner | Put the factory on Discover for public browsing |
| Main surface | Planner session and collaboration panel | Publish flow and Discover page |
| Access model | Invite links and collaborator roles | Public published page |
| Live presence | Yes | No |
| Remote cursors and drag presence | Yes | No |
| Editing together | Yes | No |
Co-op is for building the factory together. Publish is for presenting the result to other people through Discover.
Practical things to remember
A few rules make co-op easier to read:
- if you only see
Co-op Ready, the connection is up but nobody else is in the room - if you are a
Viewer, the factory opens in read-only mode - if the connection drops, the status changes to
Reconnecting... - if you need to change who can edit, use the collaborator role controls instead of relying on the invite link alone
- publishing a factory does not turn
Discoverinto a live editing session
The clean mental model is this: co-op is for working together live, and publish is for putting a finished or shareable version on Discover.