Skip to content
View LovesWorking's full-sized avatar
:electron:
:electron:

Block or report LovesWorking

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
LovesWorking/README.md

⚑ Austin (LovesWorking) ⚑

Founder @ Buoy β€” I build the debugging tools React Native should have shipped with

Typing SVG

buoy.gg npm version npm downloads GitHub stars


πŸ‘‹ The Short Version

I spent years as a lead dev shipping React Native apps for Walmart, Whataburger, Wayfair, Kwik Trip & more β€” and got tired of debugging mobile apps with console.log and prayer.

So I built Buoy: a full debugging platform for React Native. Not a tool. A platform.

  • 🧰 20+ devtools living inside your app behind one draggable floating menu β€” network, storage, state, routes, renders, performance, and more
  • πŸ“¦ 30+ packages in a single monorepo powering it all, published under @buoy-gg
  • πŸ–₯️ Buoy Desktop β€” a native external dashboard (macOS Β· Windows Β· Linux) that mirrors every tool over a live sync protocol
  • πŸ€– An MCP server so AI agents like Claude and Cursor can drive the tools themselves β€” read network traffic, inspect state, tap elements, run benchmarks, and fix your bugs on a real device
  • πŸ“Ί Runs everywhere React runs: iOS, Android, Web, Expo, RN CLI, tvOS, Android TV
  • βš™οΈ Zero config. Install, drop in one component, done.

Debugging tools shouldn't be an afterthought. They should be the reason you find the bug in minutes instead of days.

🏒 Professional Journey

banner

πŸ”₯ The Buoy Ecosystem πŸ”₯


React Buoy β€” In-App DevTools

Runs on:iOSAndroidWebTVExpoReact Native CLI

The floating devtools menu for React Native. Every tool you keep wishing existed, one bubble away β€” and it persists through reloads and crashes.

⚑ react-native-buoy · 🌊 buoy.gg

🧰 What's in the box
Tool What it does
πŸ“‘ Network Monitor Full request timeline, bodies, and response overrides
πŸ’Ύ Storage Browser Live AsyncStorage/MMKV browsing with diffing
⚑ React Query Full DevTools β€” cache, mutations, invalidation
πŸ—ƒοΈ Redux Β· Zustand Β· Jotai State inspection for every store you run
🧭 Routes Navigation events, sitemap, and stack inspection
πŸ“Š Perf Monitor FPS, JS thread, render counts, benchmarks
🎯 Highlight Updates See every re-render painted on screen
πŸ•°οΈ Time Machine Rewind and replay app state
πŸͺ΅ Console console.* capture with a Chrome DevTools-style viewer
🏷️ Env & Roles Environment badges + user impersonation
πŸ–ΌοΈ Images & Assets Image inspection, simulation, and asset auditing
🧩 Custom Tools Bring your own β€” any React component becomes a tool

Buoy Desktop β€” External Dashboard

Platform:macOSWindowsLinux

A gorgeous native desktop app that mirrors every Buoy tool outside the device. Multiple devices, one dashboard, real-time sync β€” debug your iPhone, Android TV, and web build side by side.

⚑ React-Native-Better-Dev-Tools

✨ Key Features
  • πŸ”„ Real-time monitoring across every connected device and platform
  • πŸ“± iOS, Android, Web, tvOS, Android TV, Apple Vision Pro, VR/AR and more
  • 🎨 Native UI with auto-updates built in
  • πŸ”Œ Rock-solid device communication over a local sync broker
  • πŸš€ One npm package to connect your app

πŸ€– AI-Native Debugging (MCP)

This is the part I'm most proud of. Buoy ships an MCP server, which means AI coding agents don't just read your code β€” they operate your running app. Claude can pull the actual failed request, inspect the actual store, tap through the actual screen, and verify the fix on the device.

You:    "why is the cart total wrong?"
Agent:  β†’ reads live network responses off your phone
        β†’ diffs the Zustand store against the API payload
        β†’ finds the stale persisted value
        β†’ fixes it, reloads, re-drives the screen, proves it

No more copy-pasting logs into a chat window. The agent has hands.


πŸ“Έ Visual Showcase

devtools

Buoy Desktop β€” external React Native debugging dashboard on macOS Real-time debugging on a physical iOS device


🌊 If you ship React Native, Buoy will find your bug faster than you will.

Get started at buoy.gg β†’

Built with an unreasonable amount of care by one very stubborn lead dev.

Pinned Loading

  1. react-query-external-sync react-query-external-sync Public

    A powerful debugging tool that syncs React Query state, device storage (MMKV, AsyncStorage, SecureStorage), and environment variables from your React/React Native app to an external dashboard via S…

    TypeScript 113 13

  2. Buoy-gg/buoy Buoy-gg/buoy Public

    Devtools that live in your React Native app. And answer to your agent. 15 tools Β· desktop dashboard Β· MCP server for AI agents

    690 3

  3. Buoy-gg/Buoy-Desktop Buoy-gg/Buoy-Desktop Public

    Every Buoy tool, full screen. The free desktop dashboard for Buoy React Native devtools β€” macOS, Windows & Linux

    877 13

  4. tanstack-query-dev-tools-expo-plugin tanstack-query-dev-tools-expo-plugin Public

    Bring the power of Tanstack Query DevTools to your Expo and React Native applications. Monitor, debug, and manipulate your queries in real-time across all your devices.

    TypeScript 146 2

  5. watermelondb-expo-plugin-sdk-52-plus watermelondb-expo-plugin-sdk-52-plus Public

    πŸ‰ Config plugin to auto configure `@nozbe/watermelondb` for Expo SDK 52 and Expo SDK 53

    JavaScript 35 1