Skip to content
pubscout

flutter_debug_overlay

0.2.0, released 7 days ago by sevdev.at

A debug overlay providing log viewers, HTTP inspectors, and custom actions inside your app.

Uses material_ui
$ flutter pub add flutter_debug_overlay
Source repository

What it does

It implements a global debug overlay directly in your Flutter app, enabling on-device inspection of logs and HTTP requests. It supports custom widgets for global actions and offers default triggers like touch gestures or keyboard shortcuts.

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

Use it when

  • You need to inspect logs and HTTP traffic directly on physical devices away from a computer.
  • You want a global overlay for custom debugging actions anywhere in your app.

Skip it when

  • You only need desktop-attached debugging tools like DevTools.
  • You want to avoid adding extra runtime overhead or third-party buckets for logging.

Strengths

  • Global overlay works above app navigation.
  • Built-in integrations for popular HTTP clients like Dio and http.
  • Customizable trigger options for mobile and desktop.

Weaknesses

  • Requires manual setup and wiring of LogBuckets and HttpBuckets.
  • May clutter production builds if not conditionally disabled.

Setup

Kind
Flutter widgets
Effort
Low
Code generation
No
Direct dependencies
10

Insert the DebugOverlay widget into the builder of your WidgetsApp or MaterialApp.

MaterialApp(
  builder: DebugOverlay.builder(),
  home: const MyHomePage(),
)

Alternatives

Packages that do the same job and could replace flutter_debug_overlay.

  • talker

    Provides extensive logging, error handling, and a flexible UI package for debugging Flutter apps.

  • inspector

    Alternative inspection utilities for Flutter development.

Works with

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