LIVE

Real-time

Review Sessions

A review session is a live, collaborative instance of your project's preview — like a shared screen but built for QA, with annotations, live cursors, and session replay.

THE REVIEW INTERFACE

When you start a review, BugDrop wraps your layout in the Review Interface wrapper (`BrowserFrame`). This provides tools for navigation while maintaining the original site feel. Sessions have a time limit displayed via the `SessionTimer`.

Viewport

Host

STARTING A SESSION

Start session

Click Start Review in project

Share link

Collaborative room URL

Participants join

Live cursors appear

Annotate

Click any element in real-time

1Open your project from the dashboard

2Click Start Review

3Your project preview loads inside BugDrop's review interface

4Navigate the site and create annotations

Preview uses the last successful build

To review a feature branch, trigger a build for it first, then start the session.

LIVE CURSORS

All participants see each other's cursors overlaid on the preview iframe in real-time at 50ms update intervals.

Sarah (client)

Dev — Alex

Guest: Jane Smith

cursor:move

realtimeCompleted

Broadcast cursor position (50ms throttle)

guided:start

eventCompleted

Activate guided cursor mode lock

guided:navigate

eventCompleted

Relay navigation to all followers

session:join

eventActive

Participant entered the room

GUIDED CURSOR MODE

One guide, all followers

When activated, all participants viewports follow the guide's navigation, scroll, and clicks. Only one participant can hold the guide lock at a time.

1Click Guide in the session toolbar

2Your cursor is highlighted for all participants

3Navigate — all participants follow automatically

4Click Stop Guiding to release control

Guide lock is exclusive

If another participant requests the lock while you hold it, they must wait until you release it.

INVITING COLLABORATORS

Multiple team members can review the same project simultaneously via a Collaborative Session.

1Open your project and click Start Collaborative Review

2A shared room is created with a unique link

3Share the link with team members

4All participants see each other's live cursors

GUEST REVIEWS

Clients without a BugDrop account can join via a guest link generated inside the session.

bash

# Guest links are generated inside an active session
# Format:
https://app.bugdrop.io/review/<projectId>?guest=<token>
# Guest enters name + email → joins session
# Their annotations are tagged: "Guest: Jane Smith"

No account required for guests

Guest annotations look identical to registered-user annotations. They receive an email when their annotation is resolved.

SESSION REPLAY