Buoy-gg/buoy

Buoy – In‑app developer tools

What it is – Buoy is a library you add to a React Native, Expo, Flutter, Capacitor/Ionic or Three.js app. It injects a floating menu that lets you inspect and mutate the app while it’s running: network requests, storage, state caches, navigation, render performance, 3‑D scenes, etc.

Key capabilities

• Live inspection of network calls, async storage, React‑Query/Zustand/Redux caches, routes and component renders.
• On‑the‑fly editing – change request payloads, force error or loading states, rewind time, edit environment variables, impersonate a user, toggle permissions, etc.
• Tool ecosystem – a core package (@buoy-gg/core) plus optional plug‑ins such as @buoy-gg/network, @buoy-gg/react-query, @buoy-gg/ask-buoy, @buoy-gg/scene, etc. Install only the tools you need.
• Cross‑device sync – link the in‑app menu to Buoy Desktop or the MCP server so you can control the app from a desktop UI or an AI‑driven editor.
• Platform support – native React Native/Expo, Flutter (via its own setup), Capacitor/Ionic (beta), and Web/Three.js (beta) with a 3‑D “Scene” editor.

How to get started

1. Install the core and at least one tool, e.g.

   npm install @buoy-gg/core @buoy-gg/network
   npx --package=@buoy-gg/core buoy login
   

2. Follow the quick‑start guide to mount the floating menu in your app and load your Buoy API key.
3. Add additional tools as needed (storage, time‑machine, react‑query, etc.).
4. Run a development build; a free Buoy account gives you basic MCP sync, while Pro unlocks the full server features.

Who it’s for – Mobile and web developers who want a Chrome‑DevTools‑like experience inside the actual running app, especially when debugging network/state issues that are hard to reproduce from the outside.

License – Proprietary (Buoy LLC). The repo is the open‑source front‑end of the product; usage requires a Buoy account and may need a paid plan for production deployment.