Features

Everything your users get when you add <pulse-widget> to your page.

Toolbar

A floating pill-shaped bar appears on the page with:

• Presence avatars — colored circles for each user on the page
• Pin mode — click to drop a comment anywhere
• Cursor toggle — show/hide live cursors
• Drawing mode — freehand annotations
• Activity feed — recent room events
• Settings — user preferences (toggles for each feature)

Comment Pins

Users click the pin icon in the toolbar, then click anywhere on the page to start a conversation pinned to that spot.

• Numbered dots appear at each pinned location
• Clicking a dot opens the thread in a popover
• Threads support replies, @mentions, edit, and delete
• Pin positions are responsive (stored as percentages)

Threaded Comments

A slide-out panel shows all threads in the room:

• Active threads appear first, resolved threads below
• Click a thread to expand and see all comments
• Reply to any thread with the input at the bottom
• @mention users by referencing their ID
• Edit and delete your own comments
• Resolve threads when the discussion is done

Live Cursors

See every user's cursor moving in real-time:

• Color-coded with the user's name as a label
• Throttled for performance (updates every 100ms)
• Stale cursors fade out after 3 seconds
• Can be toggled off in settings

Click Indicators

When someone clicks on the page, other users see a brief colored ripple at that position. Useful for "look here!" moments.

Presence

The toolbar shows who's on the page:

• Colored avatar circles (shows initials or profile picture)
• Overflow badge ("+3") when many users are present
• Each user is either online or idle

Follow Mode

Click any user's avatar in the toolbar to follow them — your page auto-scrolls to match their position.

• "Following Alice" banner appears
• Your page scrolls with theirs in real-time
• Click Stop, press Escape, or scroll manually to exit

Typing Indicators

When someone is typing a reply, other users see "Alice is typing..." below the thread. Auto-clears after a few seconds of inactivity.

Reactions

Click the + button below any comment to add an emoji reaction:

• 6 quick-pick emojis (thumbs up/down, heart, party, eyes, rocket)
• Click an existing reaction to toggle it
• Reaction counts update in real-time

Activity Feed

Click the clock icon in the toolbar to see recent room activity:

• New threads (with content preview)
• New comments (with content preview)
• Thread resolved/reopened events
• Relative timestamps ("just now", "5m ago")

Drawing / Annotations

Click the pen icon to enter drawing mode:

• Freehand drawing over the page
• Strokes broadcast to all users in real-time
• Strokes auto-fade after 10 seconds
• Great for quick "circle this" style annotations

Text Selections

When a user selects text on the page, other users see the selection highlighted in that user's color. Useful for "I'm looking at this paragraph" context.

Viewport Awareness

Colored pills on the right edge of the page show where other users are scrolled to. Helps you know if someone is reading the header while you're at the footer.

User Settings

Each user can customize their experience via the settings panel:

Setting	What It Controls
Show my cursor	Whether your cursor is visible to others
Show other cursors	Whether you see other people's cursors
Click indicators	Show click ripples
Appear offline	Hide from presence (stop sending heartbeats)
Comment pins	Show/hide the pin dots on the page
Viewport indicators	Show/hide the scroll position pills
Text selections	Show/hide shared selections
Drawing overlay	Show/hide drawing strokes

Settings are saved per user, per room in the browser's localStorage.