@buoy-gg/core

Devtools that live in your app. And answer to your agent.

Buoy is a floating dev menu that ships inside your React Native app. Every request, state change, render, and frame — live on the phone, on your desktop, and in Claude or Cursor. Drop in one component, install the tools you want, and they appear in the menu on their own.

Install

npm install @buoy-gg/core

Quick start

import { FloatingDevTools } from "@buoy-gg/core";

export default function App() {
  return (
    <>
      {/* Your app */}
      <FloatingDevTools />
    </>
  );
}

That's the whole setup — a floating dev menu appears inside your app. Install any tool package and it auto-appears in the menu; most need zero config, a few take one line (like passing zustandStores or calling watchAtoms()). Add a licenseKey prop to unlock Pro: production builds, the MCP server, and unlimited capture.

The 15 tools

| Tool | Package | What it does | | --- | --- | --- | | Network | @buoy-gg/network | Every request, response, timing & error — GraphQL operations extracted and named | | Storage | @buoy-gg/storage | Browse & edit AsyncStorage, MMKV & SecureStore with change history | | Env | @buoy-gg/env | Auto-discovers EXPO_PUBLIC_ vars, validates types, scores config health | | Query | @buoy-gg/react-query | TanStack Query cache — refetch, invalidate, simulate loading & error states | | Routes | @buoy-gg/route-events | Navigation events, the live stack, and the full sitemap — jump to any screen | | Debug Borders | @buoy-gg/debug-borders | Depth-colored layout borders — tap any label for testID, a11y props & styles | | Highlight Updates | @buoy-gg/highlight-updates | Every render, with the cause: mount, state, props, or parent | | Bench | @buoy-gg/perf-monitor | UI/JS FPS, CPU, memory & jank on a real device — batch benchmarks, ranked reports | | Events | @buoy-gg/events | One timeline across every tool, with LLM-friendly export presets | | Console | @buoy-gg/console | Chrome-DevTools console on device — read logs with no cable and no Metro | | Redux | @buoy-gg/redux | Inspect, dispatch & time travel — flags actions that blow the frame budget | | Zustand | @buoy-gg/zustand | State, diffs, jump-to-state, one-tap reset — no middleware needed | | Jotai | @buoy-gg/jotai | One watchAtoms() call — every event shows prev → next | | Impersonate | @buoy-gg/impersonate | Switch users, roles & flags without rebuilding | | Overlay | @buoy-gg/image-overlay | Pin Figma mockups pixel-perfect over the app |

Grab everything in one line:

npm i @buoy-gg/{core,network,storage,env,react-query,route-events,debug-borders,highlight-updates,perf-monitor,events,console,redux,zustand,jotai,impersonate,image-overlay}

Three surfaces, one live session

Every tool runs inside your app's process. The phone, the desktop, and your agent all see the same session, live.

• On the phone — tap the floating menu. Works on any device, no cable, no desktop app, no Metro.
• On your desktop — Buoy Desktop (free) mirrors the tools to full-screen panels on macOS, Windows & Linux, with a live FPS / CPU / memory HUD and remote control of the device.
• Through your agent — the Buoy MCP server gives Claude Code, Cursor, or any MCP editor structured tool calls into the running app: read live state, tap real buttons, run benchmarks on a physical device.

Free vs Pro

Every tool is free — no key, no signup, no time limit.

Pro unlocks production builds, the MCP server, and unlimited capture. Activate with one prop:

<FloatingDevTools licenseKey="YOUR_LICENSE_KEY" />

Weekend Pass: every Saturday and Sunday, every Pro feature unlocks free for everyone — built into the product, not a promo. Details at buoy.gg/pricing.

Safe in production

Everything runs in your app's process. The broker that mirrors the session to desktop and MCP binds to localhost only — nothing ever leaves your machine. You decide who sees the tools:

{isInternalUser && <FloatingDevTools />}

That one line is the whole production story: internal builds and flagged users get the full toolkit; everyone else gets nothing.

Links

• Full documentation
• GitHub
• Buoy Desktop
• Pricing

License

Proprietary software. © Buoy LLC. All rights reserved. See the Terms of Service.