Network Debugger Docs

Appearance

Network DebuggerSee Every Byte Your App Sends

HTTP, WebSocket & Socket.IO inspector for Dart and Flutter — with modern UI, waterfall timeline, breakpoints, and more

Quick Start
API Reference
GitHub
🔍

HTTP Inspection

See headers, body, timing and status for every request. Filter by method, status code, or URL pattern.

🌊

Waterfall Timeline

Visual breakdown of DNS, TLS, waiting and transfer time for each request — spot bottlenecks instantly.

🔌

WebSocket & Socket.IO

Full message history for persistent connections. Inspect frames, events, and binary payloads in real time.

⏱️

Throttling & Latency

Simulate slow networks, high latency, or dropped packets to test how your app handles poor connectivity.

🛑

Breakpoints

Pause any request mid-flight, inspect or modify it, then let it continue. Debug tricky API issues on the fly.

📝

Scripting

Write rules in Dart, Go, Rust, JS, or Python to rewrite requests, mock responses, or inject headers automatically.

🖥️

Cross-Platform

Desktop app for macOS, Windows, Linux. CLI mode for CI pipelines and headless environments. Web UI included.

Firebase RTDB

Monitor Firebase Realtime Database reads, writes and listeners — see exactly what data flows through your app.

Quick Setup ​

bash
dart pub global activate network_debugger
network_debugger

📚 Quick Start Guide →

dart
import 'package:dio_debugger/dio_debugger.dart';

final dio = Dio()..interceptors.add(DioDebugger());

📚 Dio Debugger documentation →

dart
import 'package:http_debugger/http_debugger.dart';

HttpOverrides.global = DebuggerHttpOverrides();

📚 HTTP Debugger documentation →

dart
import 'package:web_socket_debugger/web_socket_debugger.dart';

final cfg = WebSocketDebugger.attach(baseUrl: 'wss://echo.websocket.events');
final socket = await WebSocketDebugger.connect(config: cfg);

📚 WebSocket Debugger documentation →

dart
import 'package:web_socket_channel_debugger/web_socket_channel_debugger.dart';

final cfg = WebSocketChannelDebugger.attach(baseUrl: 'wss://echo.websocket.events');
final channel = WebSocketChannelDebugger.connect(config: cfg);

📚 WebSocketChannel Debugger documentation →

dart
import 'package:socket_io_client/socket_io_client.dart' as io;
import 'package:socket_io_debugger/socket_io_debugger.dart';

final cfg = SocketIoDebugger.attach(baseUrl: 'https://example.com');
final socket = io.io(cfg.effectiveBaseUrl,
  io.OptionBuilder()
    .setPath(cfg.effectivePath)
    .setQuery(cfg.query)
    .build());

📚 Socket.IO Debugger documentation →

dart
import 'package:firebase_database_debugger/firebase_database_debugger.dart';

final debugger = FirebaseDatabaseDebugger();
final ref = debugger.ref(FirebaseDatabase.instance.ref('users'));

📚 Firebase RTDB Debugger documentation →

Architecture ​

Your app sends traffic through a local Go proxy. The proxy records everything and forwards it to the real server. The UI connects to the proxy and displays traffic in real time.

Packages ​

PackageWhat it does
network_debuggerCLI launcher — starts the proxy and opens the UI
dio_debuggerAttaches the proxy to a Dio HTTP client
http_debuggerGlobal HTTP interception via HttpOverrides
web_socket_debuggerIntercepts dart:io WebSocket connections
web_socket_channel_debuggerIntercepts package:web_socket_channel
socket_io_debuggerCaptures Socket.IO events and payloads
firebase_database_debuggerTracks Firebase Realtime Database operations
hex_viewerFlutter widget for viewing binary data in HEX