flutter_blackbox 0.2.2

In-app debug & QA overlay for Flutter. Network inspector, mock engine, live logs, FPS monitor, feature flags, and automated QA reports. Dio & http adapters.

Changelog

0.2.2 - 2026-04-06

Fixed

• Added CHANGELOG updates and minor version bumps for successful pub.dev publication.

0.2.1 - 2026-04-06

Added

• ignoredRebuildWidgets config in BlackBox.setup() to allow overriding and muting noisy custom 3rd-party widgets in the Rebuild tab.
• Smart Noise Filters hardcoded over 100+ native Flutter framework base widgets (Text, AutomaticKeepAlive, Container, etc) and 60fps animators (LinearProgressIndicator) from tracking to prevent noise.

Fixed

• Corrected regex string parsing for Flutter framework's raw rebuild log output (Building/Rebuilding) so Rebuild Tracking accurately measures widget rebuilds rather than staying at zero.
• Rebuild Tracker console spam fixed. Intercepted framework logs are now securely routed to the UI tab while completely muted from terminal output for cleaner logging.
• Fixed infinite rendering loops where BlackBoxOverlay and RebuildTrackerWidget recursively logged themselves in the Rebuild store.

0.2.0 - 2026-03-24

Added

• Storage Inspector — inspect, search, edit, delete key-value pairs from any storage backend.
  • Built-in SharedPrefsStorageAdapter.
  • Adapter pattern (BlackBoxStorageAdapter) supports GetStorage, Hive, FlutterSecureStorage, etc.
• Privacy & Sensitive Data Redaction — keys matching common patterns (password, token, secret, jwt, etc.) auto-redacted.
  • Global toggle: redactSensitiveData in BlackBox.setup() (default: true).
  • 25+ built-in sensitive patterns, customizable per adapter.
  • Sensitive values show as •••••••• — can't be copied or edited.
• Widget Rebuild Tracker — track widget rebuild counts for performance bottlenecks.
  • Auto mode: debugPrintRebuildDirtyWidgets hook — zero code changes.
  • Manual mode: RebuildTracker widget wrapper (zero-cost in release builds via kDebugMode).
• Socket.IO Adapter — auto-capture all incoming socket events via socket.onAny().
  • SocketIOBlackBoxAdapter(socket) — no changes to socket code.
• HttpBlackBoxAdapter — observe-only adapter that takes your existing http.Client.

Changed

• Observe-only philosophy — all adapters now hook into libraries' built-in extension points without replacing trusted code.
• BlackBoxHttpClient is now @Deprecated — replaced by HttpBlackBoxAdapter(client).

Removed

• Feature Flags panel and LocalFlagAdapter — replaced by Storage Inspector and Rebuild Tracker.

0.1.4 - 2026-03-19

Fixed

• Bumped dio lower bounds to ^5.4.0 in pubspec.yaml to ensure compatibility with DioException and restore pub.dev points.

0.1.3 - 2026-03-19

Changed

• Renamed all public classes from DevKit to BlackBox to fully align with the new package name.

0.1.1 - 2026-03-19

Changed

• Updated README and internal configuration to correctly reflect the flutter_blackbox package name.

0.1.0 - 2025-03-19

Added

• Single-package release — Dio and http adapters bundled in core
• DevKitOverlay — tabbed debug panel above Navigator
• Network panel — request/response log with headers and body
• Mock engine — intercept any HTTP request with fake response
• Log panel — captures debugPrint() automatically
• Performance panel — live FPS graph and jank detection
• Feature flags panel — runtime toggle without restart
• Device panel — platform, screen, OS info
• QA Report — one-tap screenshot + logs + network bundle
• DioDevKitAdapter — Dio interceptor (included in core)
• DevKitHttpClient — http.Client drop-in (included in core)
• PrintLogAdapter — auto-captures debugPrint
• LocalFlagAdapter — in-memory feature flags