How prooflinedev/session-recorder-chrome-extension works
Session Recorder is a Chrome extension for capturing browser bug reproductions, annotating them, and turning sessions into reports or GitHub issues. The main workflow runs from the side panel through background capture and local session storage, then into report viewing/export or optional publishing and issue filing. Additional capabilities include page and screenshot annotation, transcription, AI summaries, and configurable personal or Proofline services. Edges reflect the supplied excerpts, source-index references, and README; unsampled implementation details are represented only where their subsystem is clear.
Main entry points: background.ts Capture coordinator · useShareReport.ts Share workflow · App.tsx Recorder panel · main.ts Report viewer
Components 23
Recording and capture
- Recorder panel
entrypoints/sidepanel/App.tsx - Capture coordinator
entrypoints/background.ts - Browser capture
lib/capture - Page annotations
lib/annotations/point-overlay.ts - Speech transcription
lib/transcription/index.ts
Reports and export
- Report viewer
entrypoints/report/main.ts - ZIP bundle builder
lib/export/bundle.ts - Markdown renderer
lib/export/markdown.ts - Evidence trimming
lib/export/trimmer.ts
Sharing and integrations
- Issue draft UI
entrypoints/share/App.tsx - Share workflow
entrypoints/share/useShareReport.ts - AI summaries
lib/sharing/summary.ts - Report publishing
lib/sharing/cloudflare.ts - GitHub issue filing
lib/sharing/github.ts - Proofline AI client
lib/proofline/ai.ts
Extension platform
- Session records
lib/session/types.ts - Local session store
lib/storage/index.ts - Extension messaging
lib/messaging.ts - Service settings
lib/sharing/settings.ts
Other components
- QA tester
- Cloudflare Pages
- GitHub
- Proofline service
Connections 29
- QA tester → Recorder panel: starts recording
README.md - Recorder panel → Capture coordinator: sends commands
- Capture coordinator → Browser capture: coordinates capture
entrypoints/background.ts - Capture coordinator → Page annotations: routes events
- Capture coordinator → Speech transcription: dispatches transcription
entrypoints/background.ts - Capture coordinator → Local session store: persists session
entrypoints/background.ts - Capture coordinator → Session records: uses event types
entrypoints/background.ts - Recorder panel → Extension messaging: uses contract
- Capture coordinator → Extension messaging: broadcasts updates
entrypoints/background.ts - Page annotations → Extension messaging: sends annotations
lib/annotations/point-overlay.ts - QA tester → Page annotations: marks evidence
README.md - QA tester → Report viewer: opens report
README.md - Report viewer → Local session store: loads session data
entrypoints/report/main.ts - Report viewer → ZIP bundle builder: builds export
entrypoints/report/main.ts - ZIP bundle builder → Evidence trimming: trims evidence
lib/export/bundle.ts - ZIP bundle builder → Markdown renderer: renders report
lib/export/bundle.ts - Markdown renderer → Session records: renders event data
lib/export/markdown.ts - QA tester → Issue draft UI: files issue
README.md - Issue draft UI → Share workflow: uses filing workflow
entrypoints/share/App.tsx - Share workflow → Local session store: loads session data
entrypoints/share/useShareReport.ts - Share workflow → AI summaries: prepares evidence
entrypoints/share/useShareReport.ts - Share workflow → Report publishing: publishes report
entrypoints/share/useShareReport.ts - Share workflow → GitHub issue filing: creates issue
entrypoints/share/useShareReport.ts - Share workflow → Service settings: loads configuration
entrypoints/share/useShareReport.ts - Report publishing → Cloudflare Pages: uploads report
- GitHub issue filing → GitHub: files issue
- Speech transcription → Proofline AI client: requests transcription
lib/transcription/index.ts - Proofline AI client → Proofline service: calls service
- Service settings → Proofline service: supports connection