Debug menu

Scope

• Provide a centralized UI for debugging without external tools.
• Allow non-engineers (QA/PM) to flip feature flags safely during testing.
• Make logs discoverable, searchable, and shareable from within the app.

Out-Of-Scope

• Not a replacement for production-grade observability or remote config.
• No persistent remote sync of flags (local-only for now).
• No alteration of the app’s release build behavior unless explicitly allowed.

Requirements

• Access:
  • Debug Menu is available only in debug/daily builds by default.
  • Optionally unlockable in release, beta with a hidden gesture and an additional confirmation warning.
• Feature Flags:
  • List all known flags with current values.
  • Toggle boolean flags.
  • Persist changes locally (survive app restarts?).
  • Expose a “Reset to defaults” action.
• Logs:
  • Display an on-device rolling buffer of recent logs (min 2,000 lines or 1–5 MB; configurable).
  • Filter by level (VERBOSE/DEBUG/INFO/WARN/ERROR) and by tag.
  • Search text query across visible logs.
  • Ability to copy selected lines and “Share” as a text file attachment.
  • Option to clear the in-memory log buffer.
• Safety:
  • Changing flags applies immediately where feasible, otherwise after app restart (with do you really want to restart prompt).
  • Add visual indicators when non-default flags are active.

UX Outline

• Entry point: from app’s settings menu within → Debugging.
  • Optionally: tap app version 7 times on About screen to reveal in non-debug (store a flag in prefs).
• Debug Menu tabs or sections:
  1. Feature Flags
     • List of flags with current value, type indicator, and description.
     • Toggle/switches for booleans; dropdowns for enums; text fields with validation for strings/ints.
     • Buttons: Reset All
  2. Logs
     • Toolbar: Level filter, Tag filter (autocomplete), Search box.
     • Paginated/virtualized scrolling list of lines: [time] [level] [tag] message.
     • Buttons: Clear, Share Logs.