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. 핵심 패키지와 최소한 하나의 도구를 설치합니다. 예:

   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와 같은 경험을 원하는 모바일 및 웹 개발자, 특히 외부에서 재현하기 어려운 네트워크/상태 문제를 디버깅할 때 유용합니다.

라이선스 – 독점(Buoy LLC). 저장소는 제품의 오픈 소스 프론트엔드입니다. 사용에는 Buoy 계정이 필요하며, 프로덕션 배포에는 유료 플랜이 필요할 수 있습니다.