UAT Bug Report Widget
Feature Overview
A floating bug-report widget on UAT and local builds lets a tester file a GitHub issue from inside the app in one tap. The widget captures the current screen plus diagnostic context (URL, user, viewport, browser, recent console logs) so triage starts with everything it needs, and creates the issue via the org-owned GitHub App (#7372). Optional short video attachments are supported (#4663).
Open Questions
No open questions.
Acceptance Criteria
Widget visibility
- ✅
bug-report.fab.visible-on-uat— a bug-report FAB is shown in the bottom-left corner on UAT and local builds for authenticated users. (#4559) - ✅
bug-report.fab.hidden-pre-auth— the FAB is hidden on pre-auth routes (login) where no session exists. (#4755) - ✅
bug-report.fab.no-occlusion-small-viewport— on small viewports (below 768px) the FAB does not occlude readable or interactive page content under its resting bottom-left position: it auto-hides (fades out and drops pointer events) while the user scrolls down and reappears on scroll-up or at the top, so content such as the "Education" category tile label on/cpd-plansstays visible and tappable. The FAB remains operable (it is never removed) and is always shown at 768px and above, so desktop/tablet layout is unchanged. Applied globally in the FAB component so every route benefits. † (#9158)
Capture & submission
- ✅
bug-report.capture.screenshot-diagnostics— the report contains a screenshot of the page plus URL, user, viewport, browser and recent console logs. (#4559) - ✅
bug-report.submit.creates-github-issue— submitting creates a GitHub issue via the org GitHub App and returns a link to it in a success notification. (#4559, #7372, #7351) - ✅
bug-report.attachments.video-optional— up to five short video recordings (MP4/MOV/WebM, ≤100 MB) may be attached; submitting without a video still succeeds. (#4663) - ✅
bug-report.submit.works-over-open-modal— the widget can be opened, filled and submitted while another form modal is already open. The title field is focused on open so the on-screen keyboard appears, the dialog does not deadlock with the underlying modal's focus trap or scroll lock, and a hint explains why Submit is disabled until a title and description are entered. (#8654)
Region selection
- ✅
bug-report.region.select-before-submit— before submitting, the reporter can drag a rectangle over the screenshot to crop it to the area the bug is about, so triage lands on the right component. † (#8494) - ✅
bug-report.region.submitted-crop— when a region is selected the submitted screenshot is the cropped region rather than the whole page, keeping the existing diagnostics. † (#8494) - ✅
bug-report.region.skippable-whole-page— region selection is optional; the whole-page screenshot remains the default and the fallback, and a committed crop can be reverted to the whole page. † (#8494)
Open GitHub Issues
Change Log
| Date | Change |
|---|---|
| 2026-09-29 | Removed the dead "/onboarding" entry from PRE_AUTH_ROUTES in BugReportButton.tsx and updated the bug-report.fab.hidden-pre-auth AC to match — the route was removed in #8027 (2026-06-02) and this list entry could no longer match anything. |
| 2026-06-16 | The bug-report widget can now be opened, filled and submitted while another form modal is already open. The title field is focused on open so the on-screen keyboard appears, the dialog no longer deadlocks with the underlying modal's focus trap or scroll lock, and a hint explains why Submit is disabled until a title and description are entered. |
| 2026-06-10 | The bug-report widget gains a skippable drag-to-select region step. Before submitting, the reporter can drag a rectangle over the screenshot to crop it to the area the bug is about; the cropped region is what gets submitted, alongside the unchanged diagnostics. Whole-page remains the default and one-tap fallback, and a committed crop can be reverted to the whole page. |