BUOY Devtools

⚠️ ACTIVE DEVELOPMENT This project is under active development. If you encounter any issues, please open an issue on GitHub.

See the bug. Reproduce it. Fix it in seconds.

On-device devtools for React Native — network, storage, env, routes, query cache, Redux, Jotai — available to your whole team in dev, staging, and production.

Zero config: install → appears
QA/support can reproduce & export
Modular: use only what you need

📚 Full Documentation · 🚀 Quick Start Guide

BUOY Demo

Quick Start

1. Install

npm install @buoy-gg/core
# or: yarn add / pnpm add / bun add

2. Add to Your App

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

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

That's it — installed tools automatically appear in the floating menu.

Available Tools

| Tool | Package | What It Does | | ----------- | ------------------------------- | ------------------------------------------------- | | Network | @buoy-gg/network | Monitor API requests, responses, timing, errors | | Storage | @buoy-gg/storage | Browse and edit AsyncStorage & MMKV | | Environment | @buoy-gg/env | View and validate env variables with type checking | | Query | @buoy-gg/react-query | TanStack Query devtools with cache inspection | | Routes | @buoy-gg/route-events | Track navigation changes and browse routes | | Profiler | @buoy-gg/debug-borders | See re-renders, track counts, debug performance | | Highlights | @buoy-gg/highlight-updates | Visual component re-render tracking | | Redux | @buoy-gg/redux | Inspect state, actions, diffs, and time-travel | | Jotai | @buoy-gg/jotai | Atom inspector with live values, diffs, and history | | Events | @buoy-gg/events | Unified timeline across all tools with LLM export |

Install any tool and it auto-appears in the menu:

npm i @buoy-gg/{core,env,network,storage,react-query,route-events,debug-borders,highlight-updates,redux,jotai,events}

Full tool docs + screenshots: buoy.gg/docs/tools

Why BUOY?

| | BUOY | Flipper | Reactotron | RN Debugger | | ---------------------------- | :--: | :-----: | :--------: | :---------: | | On-device (no desktop app) | ✅ | ❌ | ❌ | ❌ | | Works in production | ✅ | ❌ | ❌ | ❌ | | QA/support can use it | ✅ | ❌ | ❌ | ❌ | | Zero config setup | ✅ | ❌ | ❌ | ❌ |

Safe in Production

You control who sees it. BUOY runs entirely on-device — no data leaves the device, no remote connections.

<>
  {/* Your app */}
  {isInternalUser && <FloatingDevTools />}
</>

Early Access

Free during early access. Paid features coming (support tools, bug report workflows, and more).

Contributing

Bugs / feature requests: GitHub Issues
PRs welcome

License

See Terms of Service for usage terms.

💙 Credits

Big thanks to galaxies.dev — their content helped me get up to speed with React Native early on, and I strongly recommend it as a resource for anyone making the jump from web to mobile.

Buoy

Install / Use

README