session-replay

name	session-replay
description	Set up session replay for visual debugging. Use when implementing DOM recording with privacy controls.
triggers	["session replay","record user sessions","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
• Validating error context

Privacy Requirements (Must Do)

Mask by default:

• All text input fields
• Passwords and sensitive data
• Financial information
• Personal identifiers
• User photos/documents
• Chat messages

Performance Budget

Resource	Limit
CPU	<3% additional
Memory	<10MB additional
Network	Batch uploads, compress
Bundle	Lazy load SDK

Best Practices

Do	Don't
Lazy load replay SDK	Include in main bundle
Mask all inputs by default	Allow recording of inputs
Sample sessions (10-20%)	Record 100%
Focus on error sessions	Record everything
Test privacy masking	Assume it works

Sampling Strategy

replaysSessionSampleRate: 0.1   // 10% of sessions
replaysOnErrorSampleRate: 1.0   // 100% of error sessions

Implementation

Load vendor-specific configuration from references/platforms/*.md when generating code.

Vendor	Config Reference
Sentry	references/platforms/sentry.md
Datadog	references/platforms/datadog.md
LogRocket	references/platforms/logrocket.md
FullStory	references/platforms/fullstory.md

Related

• skills/error-tracking - Correlating errors with replays
• skills/user-journey-tracking - Session context