🎭 Backstage

pub package License: MIT

A production-ready in-app debugging console for Flutter applications. Backstage provides a hidden, gesture-activated logging interface that gives developers, QA teams, and support engineers real-time insight into application behavior without requiring development builds or external debugging tools.

Perfect for: Production debugging, QA testing, user support, and development troubleshooting.

πŸ“± Demo

Coming soon: Screenshots and GIFs showing console activation and usage

✨ Features

πŸ”’ Production-Safe

  • Hidden activation: 5 rapid taps or long-press gesture
  • Optional passcode protection: Secure access in production builds
  • No performance impact: Zero overhead when disabled
  • Safe shipping: No visible UI elements unless activated

πŸ“Š Comprehensive Logging

  • Print capture: Intercepts print() and debugPrint() output
  • Flutter errors: Captures framework errors and exceptions
  • Zone errors: Optional async error capture with runZoned
  • Custom logging: Direct API for structured application logs
  • Stack traces: Full debugging context for errors

πŸŽ›οΈ Advanced Filtering

  • Log levels: Debug, Info, Warning, Error filtering
  • Tag-based filtering: Categorize and filter by functional area
  • Real-time search: Live filtering of log content
  • Pause/Resume: Stop updates for detailed inspection

πŸ’Ύ Smart Persistence

  • State management: Remembers enabled/disabled state across sessions
  • Configuration persistence: Maintains user preferences
  • Cross-platform: Works on iOS, Android, Web, Desktop

🎨 User Experience

  • Draggable interface: Position console anywhere on screen
  • Material Design: Follows platform design guidelines
  • Theme integration: Adapts to app's color scheme
  • Minimal footprint: Compact, non-intrusive design

Libraries

backstage