session-replay

name	session-replay
description	Set up session replay for visual debugging. Use when implementing screen recording, replay features, or visual debugging tools.
triggers	["record user sessions","replay user actions","screen recording","see what user did","set up session replay","visual debugging"]
priority	3

Session Replay

Capture visual recordings of user sessions for debugging.

When to Use

• Reproducing hard-to-debug issues
• Understanding user confusion
• QA and support investigations

Privacy Requirements (Must Do)

Mask by default:

• All text input fields
• Passwords and sensitive data
• User-generated content
• Financial information
• User photos/documents

Performance Budget

Resource	Limit
CPU	<5% additional
Memory	<20MB additional
Network	Batch on WiFi
Battery	Pause when low

Capture Strategies

Strategy	Fidelity	Overhead
Screenshots (1-2 fps)	Lower	Lower
View hierarchy recording	Higher	Moderate
Hybrid (screenshots + events)	Best	Moderate

Best Practice

Don't record everything. Target:

• Error sessions only (rolling buffer)
• Key user journeys
• 1-10% sampling for general insights

Implementation

See references/session-replay.md for:

• Platform-specific setup
• Privacy masking patterns
• Vendor configurations (Sentry, Datadog, New Relic)