Buoy. One toolkit, every team. Switch environments, sign in as a customer, force an error or rewind state, right inside the running app.

### Developer tools that live inside your app. buoy.gg · Docs · Quick start · Desktop · Pricing [![npm version](https://img.shields.io/npm/v/@buoy-gg/core?style=flat-square&labelColor=10302a&color=2a9d78&label=%40buoy-gg%2Fcore)](https://www.npmjs.com/package/@buoy-gg/core) [![npm downloads](https://img.shields.io/npm/dm/@buoy-gg/core?style=flat-square&labelColor=10302a&color=2a9d78&label=downloads%2Fmonth)](https://www.npmjs.com/package/@buoy-gg/core) [![legacy downloads](https://img.shields.io/npm/dt/react-native-react-query-devtools?style=flat-square&labelColor=10302a&color=e8a33d&label=legacy%20downloads)](https://www.npmjs.com/package/react-native-react-query-devtools)

Buoy puts a floating menu in your app. Use it to check web calls, storage and query caches. You can check stores, routes, renders and speed too. Change them while your app runs. Link the same session to Buoy Desktop or MCP. Or use Ask Buoy right in your app. Flutter has its own [setup for debug builds](https://buoy.gg/buoy/latest/docs/flutter/quick-start). [Capacitor / Ionic (Beta)](https://buoy.gg/buoy/latest/docs/capacitor) uses the web tools on iOS and Android. [Solid (Beta)](https://buoy.gg/buoy/latest/docs/web/solid) works in Solid 1.9 apps built with Vite. [Vue and Nuxt (Beta)](https://buoy.gg/buoy/latest/docs/web/vue) works in Vue 3.3 and up built with Vite, and in Nuxt 4. [Three.js (Beta)](https://buoy.gg/buoy/latest/docs/web/three) works with R3F and plain apps. Use Scene to see and edit 3D objects.

## Get started The quickest way in is to let your coding agent do it. Paste the prompt below into Claude Code, Cursor or Codex. It follows [buoy.gg/install.md](https://buoy.gg/install.md), installs the core plus the tools that match your dependencies, and tells you how to check it on the device.

Agent install prompt

```text Install Buoy, the in-app devtools for React Native and Expo, in this project. Read the full instructions first: curl -fsSL https://buoy.gg/install.md Read the raw text, not a summary. If curl is unavailable, use any HTTP tool you have. Ask me to paste the document only if nothing can fetch it. Do the install yourself: inspect the repo, run the commands, edit the files. Do not hand me steps you can run. Work out the routine decisions from the repo: package manager, which app to target, where the menu mounts, which Buoy tools match the dependencies already installed. If Buoy is already partly installed, repair and extend it; never add a second mount, provider, or package set. When instructions conflict, follow this order: what I say here, then the document's rules about which packages exist and what needs my permission, then this project's own constraints, then the rest of the document, then your judgment. Ask me before: adding a native dependency, opening a browser or creating an account, changing what a production build does beyond what the document specifies, or anything hard to undo. Do not commit. You are not done when the packages install. Run this project's existing typecheck; add no tooling. Then report what you installed and why, what you skipped and why, every file you changed, what you verified, and the exact steps I take on the device to confirm the menu appears and captures a request. ```

To install by hand, start with the core and the Network tool, then sign in: ```bash npm install @buoy-gg/core @buoy-gg/network npx --package=@buoy-gg/core buoy login ``` Mounting the menu, loading your key and adding more tools are covered in the [Quick start](https://buoy.gg/buoy/latest/docs/quick-start). You need a development build and a Free or Pro Buoy account. ## See it work Each tool has a short film on its docs page, recorded on a real app.


Read, time and override requests	Edit cached data, force loading and error states	An agent inside your app

## Tools Install only the ones your app needs. Each link goes to its guide. [Network](https://buoy.gg/buoy/latest/docs/tools/network) · [Storage](https://buoy.gg/buoy/latest/docs/tools/storage) · [Time Machine](https://buoy.gg/buoy/latest/docs/tools/time-machine) · [Scenarios](https://buoy.gg/buoy/latest/docs/tools/scenarios) · [Bug Links](https://buoy.gg/buoy/latest/docs/tools/bug-links) · [Memory Leaks](https://buoy.gg/buoy/latest/docs/tools/memory-leaks) · [Clock](https://buoy.gg/buoy/latest/docs/tools/clock) · [Lifecycle](https://buoy.gg/buoy/latest/docs/tools/lifecycle) · [Location](https://buoy.gg/buoy/latest/docs/tools/location) · [Permissions](https://buoy.gg/buoy/latest/docs/tools/permissions) · [Ask Buoy](https://buoy.gg/buoy/latest/docs/tools/ask-buoy) · [Env](https://buoy.gg/buoy/latest/docs/tools/env) · [React Query](https://buoy.gg/buoy/latest/docs/tools/react-query) · [Routes](https://buoy.gg/buoy/latest/docs/tools/routes) · [Debug Borders](https://buoy.gg/buoy/latest/docs/tools/debug-borders) · [Highlight Updates](https://buoy.gg/buoy/latest/docs/tools/highlight-updates) · [Bench](https://buoy.gg/buoy/latest/docs/tools/perf-monitor) · [JS Top](https://buoy.gg/buoy/latest/docs/tools/js-top) · [Images](https://buoy.gg/buoy/latest/docs/tools/images) · [Scene (Beta)](https://buoy.gg/buoy/latest/docs/tools/three) · [Assets](https://buoy.gg/buoy/latest/docs/tools/assets) · [Events](https://buoy.gg/buoy/latest/docs/tools/events) · [Console](https://buoy.gg/buoy/latest/docs/tools/console) · [Sentry](https://buoy.gg/buoy/latest/docs/tools/sentry) · [Redux](https://buoy.gg/buoy/latest/docs/tools/redux) · [Zustand](https://buoy.gg/buoy/latest/docs/tools/zustand) · [Jotai](https://buoy.gg/buoy/latest/docs/tools/jotai) · [Impersonate](https://buoy.gg/buoy/latest/docs/tools/impersonate) · [TV Remote](https://buoy.gg/buoy/latest/docs/tools/tv-remote) · [Focus Inspector](https://buoy.gg/buoy/latest/docs/tools/focus-inspector) · [Camera](https://buoy.gg/buoy/latest/docs/tools/camera) · [Native Profiler](https://buoy.gg/buoy/latest/docs/tools/native-profiler) · [Overlay](https://buoy.gg/buoy/latest/docs/tools/image-overlay) · [OTA Updates](https://buoy.gg/buoy/latest/docs/tools/ota-update-inspector) ## Beyond the device [Buoy Desktop](https://github.com/Buoy-gg/Buoy-Desktop) shows your connected tools in desktop panels and lets you switch between devices. The [MCP server](https://buoy.gg/buoy/latest/docs/mcp) lets an AI editor read and change the running app. A free account gets the basic MCP, and Pro adds the full MCP. The MCP also runs the [Sim Farm](https://buoy.gg/buoy/latest/docs/tools/sim-farm). It gives [Buoy Optimize](https://buoy.gg/buoy/latest/docs/optimize) many slim iOS sims or Android phones, so your agent can try many speed ideas at once. The [Chrome Farm](https://buoy.gg/buoy/latest/docs/tools/chrome-farm) runs many slim Chromes on your web app, so your tests run side by side. [Buoy Web](https://buoy.gg/buoy/latest/docs/buoy-web) lets your AI use Chrome for you, with real clicks. It needs nothing in your app. Desktop and the MCP's app tools need `@buoy-gg/external-sync` in your app; the [Desktop guide](https://buoy.gg/buoy/latest/docs/desktop) covers the connection. Buoy starts in development builds. Turning it on in a shipped app takes Pro and your own access checks; read the [component reference](https://buoy.gg/buoy/latest/docs/floating-devtools) before you do. ## Feedback Found a bug, or want a tool that doesn't exist yet? [Open an issue](https://github.com/Buoy-gg/buoy/issues). Feature requests shape what gets built next. ## License Proprietary software. © Buoy LLC. All rights reserved. See the [Terms of Service](https://buoy.gg/terms). ### Native Profiler Trace native CPU work on iOS Simulator or Android. Find hot threads and long UI work in MCP or Desktop. Needs a Buoy Pro app. [Read the guide](https://buoy.gg/buoy/latest/docs/tools/native-profiler).