Debug mode

Apps MUST include a debug-only configuration panel (not in release builds):

  • Feature flag overrides
  • Analytics event log
  • A/B test variant picker
  • Environment info (version, build, OS, device)

Access methods:

  • Apple (iOS): Shake gesture, guarded by #if DEBUG
  • Apple (macOS): Debug menu item, guarded by #if DEBUG
  • Android: Shake gesture, guarded by BuildConfig.DEBUG
  • Web: /debug route, guarded by NODE_ENV === 'development'
  • Windows: Debug-only settings page, guarded by #if DEBUG

Debug Mode

Apps MUST include a debug-only configuration panel (not in release builds) with:

  • Feature flag overrides
  • Analytics event log
  • A/B test variant picker
  • Environment info (version, build, OS, device)

TypeScript

Access via /debug route or keyboard shortcut (Ctrl+Shift+D), guarded by process.env.NODE_ENV === 'development'.

Windows

Dev-only settings page guarded by #if DEBUG:

  • Feature flag overrides
  • Analytics event log
  • Environment info (app version, OS version, device)
  • Access via navigation menu item visible only in debug builds
version
1.0.0
platforms
ios, kotlin, macos, typescript, web, windows
tags
debug-mode, feature-management
author
Mike Fullerton
modified
2026-03-27

Change History

Version Date Author Summary
1.0.0 2026-03-27 Mike Fullerton Initial creation