debug overlay - BevvyTech/BrewskiDocs GitHub Wiki

Admin Debug Overlay

Key facts:

  • Gated by the admin.debug feature 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 browser fetch calls 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.
⚠️ **GitHub.com Fallback** ⚠️