buoy_network 0.2.0

Buoy network inspector for Flutter — captures all dart:io HTTP traffic via HttpOverrides (package:http, dio, images) with an in-app panel and live streaming to Buoy Desktop.

Buoy Network Inspector for Flutter

See every HTTP request your Flutter app makes — in the app, on your desktop, and from your AI editor.

Buoy captures all dart:io traffic in one hook: package:http, dio, Image.network, cached images, GraphQL clients. Inspect requests in a floating in-app panel, stream them live to the Buoy Desktop dashboard, or query them from your editor via the Buoy MCP server.

Beta — the network inspector is the first Buoy tool on Flutter. The full React Native suite is coming to Flutter tool by tool; vote for what's next on the roadmap.

Install

flutter pub add buoy_network

Quick start

import 'package:buoy_network/buoy_network.dart';

void main() {
  if (kDebugMode) registerBuoyNetwork();   // capture + tool registration
  runApp(const MyApp());
}

// In your MaterialApp:
builder: (context, child) => BuoyDevTools(
  deviceName: 'My App',
  child: child ?? const SizedBox.shrink(),
),

That's it — registerBuoyNetwork() installs the HTTP hook and registers the tool; BuoyDevTools mounts the in-app panel and auto-connects to Buoy Desktop. (Or use the buoy umbrella and skip even the register call.)

What gets captured

Everything that rides dart:io's HttpClient: package:http, dio (attributed separately), Flutter's own image loading, cached_network_image misses, graphql_flutter/ferry. Request/response headers and bodies, timing, status, errors — with GraphQL operation names when tagged via X-Request-Client: graphql.

Known gaps (documented, by design): cupertino_http/cronet_http native clients, gRPC, secondary isolates, Flutter web.

Buoy Desktop

The desktop dashboard shows live traffic from every connected device — simulators connect automatically (localhost), physical devices take a socketUrl. The same connection powers the Buoy MCP server, so your AI editor can read your app's traffic.

---

📚 Docs · Roadmap · React Native version

Proprietary software. © Buoy LLC. Terms