Skip to content
pubscout

flutter_blackbox

0.8.1, released 3 days ago by an unverified publisher

All-in-one Flutter debug overlay and live remote web dashboard for network, logs, and crashes.

WASM-ready
$ flutter pub add flutter_blackbox
Source repository

What it does

Provides an in-app debug overlay and remote web dashboard to inspect network traffic, logs, widget rebuilds, performance, storage, and crashes. It automatically disables capture in release builds and supports optional adapters for specific libraries.

AI-written summary of version 0.8.1, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You need a comprehensive on-device and remote debugging overlay during QA and development.
  • You want to inspect network requests, storage, performance, and application logs without leaving your app.

Skip it when

  • You are building for a platform where visual overlays or debugging tools are not desired.
  • You only require a simple logging library without UI overlay features.

Strengths

  • Zero impact in production due to automatic release build disabling.
  • Comprehensive feature set including network inspection, performance metrics, storage viewing, and crash logging.
  • Supports streaming diagnostics to a remote web companion.

Weaknesses

  • Adds overhead to debug builds and package footprint.
  • Requires manual adapter setup or CLI generation for certain custom third-party libraries.

Setup

Kind
Flutter widgets
Effort
Low
Code generation
No
Direct dependencies
6

Call BlackBox.setup() and wrap your app with BlackBoxOverlay. Optionally run dart run flutter_blackbox:init --generate for adapters.

import 'package:flutter/foundation.dart';
import 'package:flutter_blackbox/flutter_blackbox.dart';

void main() {
  BlackBox.setup(
    trigger: const BlackBoxTrigger.floatingButton(),
    enabled: kDebugMode,
  );
  runApp(const BlackBoxOverlay(child: MyApp()));
}

Alternatives

Packages that do the same job and could replace flutter_blackbox.

  • talker

    Advanced and extensible exception handling and logging tool for Flutter apps.

  • logger

    Simple, pretty, and powerful logger for Flutter with zero UI overlay overhead.

Works with

Packages commonly used together with flutter_blackbox: ones it builds on, ones built on it, and its own family.