Collaboration

Work together in real-time with BlockForge's collaboration features.

Real-Time Collaboration

BlockForge supports real-time collaborative editing powered by Y.js and Hocuspocus.

Features

• Live cursors - See where collaborators are editing
• Real-time sync - Changes appear instantly for all users
• Conflict resolution - Automatic merging of concurrent edits
• Presence awareness - See who's viewing or editing pages

Getting Started

Sharing Pages

1. Open the page you want to share
2. Click the "Share" button
3. Choose sharing options:
   • Public link - Anyone with the link can view/edit
   • Workspace members - Share with workspace collaborators
   • Specific users - Invite specific people

Permissions

• View - Read-only access
• Comment - Can view and add comments
• Edit - Full editing access
• Admin - Full control including sharing settings

Comments

Add comments to specific parts of content.

Adding Comments

1. Select text - Highlight the content
2. Click comment icon - Or use Cmd/Ctrl + Shift + M
3. Type comment - Add your feedback or note
4. Submit - Save the comment

Managing Comments

• View all comments - See all comments on a page
• Reply to comments - Threaded conversations
• Resolve comments - Mark as resolved when addressed
• Mention users - Tag collaborators with @username

Live Cursors

See where your collaborators are working in real-time.

Cursor Features

• Color-coded cursors - Each user has a unique color
• Selection highlighting - See what others have selected
• Name tags - Hover to see who's editing
• Active regions - Visual indicators of editing areas

Presence Indicators

• Online status - See who's currently viewing
• Activity indicators - Know when someone is typing
• Last edited - See who made recent changes

Conflict Resolution

BlockForge automatically handles conflicts when multiple users edit simultaneously.

How It Works

• Operational transforms - Conflicts resolved at the operation level
• Automatic merging - No manual conflict resolution needed
• Preserved changes - Both users' edits are preserved when possible
• Conflict indicators - Visual feedback when conflicts occur

Best Practices

1. Communicate - Use comments to coordinate large changes
2. Avoid simultaneous edits - For same section when possible
3. Use presence indicators - Be aware of who's editing
4. Review changes - Check page history for significant edits
5. Set clear permissions - Use appropriate access levels

Collaboration Settings

Workspace Settings

• Default permissions - Set default access for new pages
• Guest access - Allow external collaborators
• Export settings - Control what can be exported

Page Settings

• Page-level permissions - Override workspace defaults
• Comment settings - Control commenting permissions
• Sharing restrictions - Limit sharing options

Team Features

Workspaces

• Team workspaces - Dedicated spaces for teams
• Role management - Assign roles (Admin, Editor, Viewer)
• Workspace analytics - Track team activity

Notifications

• Mention notifications - Get notified when mentioned
• Comment replies - Stay updated on conversations
• Page updates - Know when shared pages change

Next Steps

• Learn about collections
• Explore AI features
• Master keyboard shortcuts