debug overlay - BevvyTech/BrewskiDocs GitHub Wiki
Key facts:
- Gated by the
admin.debugfeature flag (super users bypass the flag automatically). - Renders a 🐞 toggle button in the top-right corner; clicking opens a semi-transparent panel anchored to the viewport.
- Captures client timings (DOM content loaded, first contentful paint, time since navigation) using the Performance API.
- Logs every Admin API request issued through
apiFetch, plus direct browserfetchcalls that bypass the wrapper, including method, status, duration, and JSON snippets. - Shows current session context (operator email, active team, role, permission simulation state, stored theme).
- Data never leaves the browser; instrumentation only initialises when the flag is on and tears down automatically when disabled.
Intended workflows:
- Enable the flag via the Feature Flags settings page, reload the Admin app, and toggle the overlay to inspect API calls or confirm timing data.
- Drill into a request to review request/response previews when debugging integrations or customer reports.
- Verify session metadata (team, role, simulation) before reproducing role-specific issues.