Skip to content

Conversation

@le-vlad
Copy link
Contributor

@le-vlad le-vlad commented Nov 24, 2025

  • Add scroll depth tracking normalized to screen size for heatmap generation

    • Track scroll milestones (25%, 50%, 75%, 90%, 100%)
    • Capture scroll snapshots with normalized positions
    • Send final scroll depth on page unload
  • Add optional RRWeb session recording integration

    • Dynamically load RRWeb script from CDN
    • Privacy-focused defaults (mask inputs, block sensitive classes)
    • Batch recording events and flush periodically
  • New configuration options:

    • data-track-scroll-depth: Enable/disable scroll tracking (default: true)
    • data-scroll-throttle-ms: Throttle interval (default: 250ms)
    • data-scroll-depth-intervals: Customize milestone percentages
    • data-enable-session-recording: Enable session recording (default: false)
    • data-rrweb-cdn-url: Custom RRWeb CDN URL
  • Update all framework integrations (React, Next.js, Vue, Svelte)

    • Add useScrollData hook/composable for scroll heatmap data
    • Add useSessionRecording hook/composable for recording control
    • Export new types: ScrollHeatmapData, RecordingStatus, RecordingOptions

    Related to Missing scroll depth tracking #1

- Add scroll depth tracking normalized to screen size for heatmap generation
  - Track scroll milestones (25%, 50%, 75%, 90%, 100%)
  - Capture scroll snapshots with normalized positions
  - Send final scroll depth on page unload

- Add optional RRWeb session recording integration
  - Dynamically load RRWeb script from CDN
  - Privacy-focused defaults (mask inputs, block sensitive classes)
  - Batch recording events and flush periodically

- New configuration options:
  - data-track-scroll-depth: Enable/disable scroll tracking (default: true)
  - data-scroll-throttle-ms: Throttle interval (default: 250ms)
  - data-scroll-depth-intervals: Customize milestone percentages
  - data-enable-session-recording: Enable session recording (default: false)
  - data-rrweb-cdn-url: Custom RRWeb CDN URL

- Update all framework integrations (React, Next.js, Vue, Svelte)
  - Add useScrollData hook/composable for scroll heatmap data
  - Add useSessionRecording hook/composable for recording control
  - Export new types: ScrollHeatmapData, RecordingStatus, RecordingOptions
@le-vlad le-vlad requested a review from isntaname November 24, 2025 12:44
@le-vlad le-vlad self-assigned this Nov 24, 2025
…ework SDKs

- Add framework SDK documentation (React, Next.js, Vue, Svelte)
- Document scroll depth tracking with metrics explanation
- Document session recording with RRWeb integration
- Explain privacy CSS classes (zori-block, zori-ignore, zori-mask)
- Add configuration reference table with all options
- Document all automatic events tracked
- Streamline and modernize documentation structure
@le-vlad le-vlad removed the request for review from isntaname December 8, 2025 19:36
@le-vlad le-vlad changed the title Add scroll tracking and optional session recording Add scroll tracking and optional session recording. Closes #1 Dec 8, 2025
@le-vlad le-vlad added the enhancement New feature or request label Dec 8, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants