Buoy-gg/buoy

Buoy – アプリ内開発者ツール

概要 – Buoy は、React Native、Expo、Flutter、Capacitor/Ionic、または Three.js アプリに追加するライブラリです。アプリの実行中に、ネットワークリクエスト、ストレージ、状態キャッシュ、ナビゲーション、レンダリングパフォーマンス、3D シーンなどを検査および変更できるフローティングメニューを注入します。

主な機能

• ライブ検査 – ネットワーク呼び出し、非同期ストレージ、React-Query/Zustand/Redux キャッシュ、ルート、コンポーネントレンダリング。
• その場での編集 – リクエストペイロードの変更、エラー状態やローディング状態の強制、時間の巻き戻し、環境変数の編集、ユーザーの偽装、権限の切り替えなど。
• ツールエコシステム – コアパッケージ（@buoy-gg/core）に加えて、@buoy-gg/network、@buoy-gg/react-query、@buoy-gg/ask-buoy、@buoy-gg/scene などのオプションプラグイン。必要なツールだけをインストールします。
• クロスデバイス同期 – アプリ内メニューを Buoy Desktop または MCP サーバーにリンクして、デスクトップ UI または AI 駆動のエディターからアプリを制御できます。
• プラットフォームサポート – ネイティブ React Native/Expo、Flutter（独自のセットアップ経由）、Capacitor/Ionic（ベータ版）、Web/Three.js（ベータ版）と 3D「シーン」エディター。

始め方

1. コアと少なくとも 1 つのツールをインストールします。例：

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

2. クイックスタートガイドに従って、アプリにフローティングメニューをマウントし、Buoy API キーを読み込みます。
3. 必要に応じて追加のツール（ストレージ、タイムマシン、react-query など）を追加します。
4. 開発ビルドを実行します。無料の Buoy アカウントで基本的な MCP 同期が利用でき、Pro で完全なサーバー機能が利用可能になります。

対象ユーザー – 実際の実行中のアプリ内で Chrome DevTools のような体験を求めるモバイルおよび Web 開発者。特に、外部から再現が難しいネットワーク/状態の問題をデバッグする場合に役立ちます。

ライセンス – プロプライエタリ（Buoy LLC）。リポジトリは製品のオープンソースフロントエンドです。使用には Buoy アカウントが必要で、本番展開には有料プランが必要な場合があります。