BUOY
Documentation
Getting Started
Fundamentals
Desktop App
AI Automation
Available Tools

Overview

Buoy is a complete devtools platform for Flutter (beta). It turns hours into seconds for developers, QA, and product teams on tasks like regression testing, bug reproduction, performance work, and environment validation.

One devtools engine, three ways to reach your running app:

  • On your phone — a zero-config floating menu inside your app, in dev, staging, and production.
  • On your desktop — Buoy Desktop, a free dashboard for macOS, Windows & Linux that mirrors your tools with a live performance HUD.
  • Through your AI — the MCP server lets Claude Code, Cursor, or any MCP editor inspect and control your live app (Pro).

Install once. Reach every tool from wherever you work. Flutter devices show up next to your React Native devices on the same broker.

Who It's For

Developers

Stop guessing. See exactly what's happening.

QA

Test things that were previously untestable.

Customer Support

See exactly what your users see.

Product & Everyone Else

Remove the friction that slows everyone down.

This isn't a "nice to have." It's the difference between hours of debugging and coordination versus seconds. The time savings compound across your entire team.

What You Get

ToolWhat It Does
NetworkSee every API call — package:http, dio, image loads, GraphQL
StorageBrowse and edit shared_preferences in real-time
EnvironmentValidate env/config with type checking and a health score
ConsoleA Chrome-DevTools-style console for every print / debugPrint / log
Perf MonitorLive on-device HUD — FPS, jank, CPU, and memory
ImagesEvery image load with cache verdict, timing, oversize audit & failure diagnosis
RiverpodInspect provider state, live values, diffs, and history
Route InspectorTrack go_router navigation and browse your route structure
Events TimelineUnified timeline across all tools with LLM-ready export
ImpersonateInject impersonation headers to debug as any user
Image OverlayOverlay design mockups on your app for pixel-perfect comparison

Why Buoy

  • Zero config — flutter pub add buoy, wrap one widget, tools appear.
  • Three ways in — The same tools on your phone, on your desktop, and through your AI agent.
  • Works everywhere — Dev, staging, production. Same tools for everyone.
  • Modular — Only install what you need. Each tool is a separate pub package.
  • Same protocol as RN — Flutter devices show up next to React Native on Desktop and MCP.

Quick Start

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

MaterialApp(
  builder: (context, child) => BuoyDevTools(
    licenseKey: 'YOUR_LICENSE_KEY',
    child: child ?? const SizedBox.shrink(),
  ),
)

import 'package:buoy/buoy.dart';

MaterialApp(
  builder: (context, child) => BuoyDevTools(
    licenseKey: 'YOUR_LICENSE_KEY',
    child: child ?? const SizedBox.shrink(),
  ),
)

Install the umbrella (or any tool package) and it appears in the menu. Get your license key at buoy.gg/pricing.

Build Your Own Tools

Need something specific to your app? Drop in custom tools via the tools prop on BuoyDevTools. Build internal debugging utilities, feature flag toggles, or team-specific inspectors that integrate with the floating menu.

Next Steps

Edit on GitHub
Quick Start