Overview

Buoy for Android adds Buoy's tools to a native Android app. It works with Jetpack Compose and with plain Android views. It is its own SDK, apart from the React Native packages. It ships as one Maven package, gg.buoy:buoy-android.

Android support is in beta. The tools work on the phone, in Buoy Desktop and through the MCP server. They don't match the React Native tools in every way. Each tool in Tools says what Android leaves out.

Start here

Follow the Quick Start.

What you get

One package brings in every tool:

Tool	What it covers on Android
Network	Web calls made with OkHttp, fake answers and slow modes
Console	The app's own log lines, and BuoyConsole calls
Storage	SharedPreferences, plus MMKV and safe stores you add
Env	Values and rules you give it
Impersonate	User search, and a header on calls Buoy sees
Image Overlay	A design image laid over the app
Images	Load, fail, retry, blank and swap for BuoyAsyncImage
Notifications	Notifications sent through Buoy, taps and test alerts
Routes	Screens, route patterns and moving around the app
Scenarios	Saved app setups you can run again
Time Machine	Save the app's state and put it back
Events	One list of web, storage and route events
Assets	What the APK ships: sizes, copies and baselines
Clock	Jump, freeze or speed up time read through BuoyClock
Lifecycle	What the app does when people leave and come back
Location	Fake places, routes and areas for BuoyLocationProvider
Permissions	Denied, blocked and not-asked states for BuoyPermissions
Bench	A speed HUD, and test runs you can save and compare
Highlight	Redraws of views marked with buoyTrackRenders
Debug Borders	Lines around views, to check the layout
Ask Buoy	Ask about the app in plain words. It can use the tools.

Some tools only exist for JavaScript. React Query, Redux, Zustand, Jotai, JS Top and Three are not in the Android SDK. Sentry is not on Android yet.

What you need

• An app with minSdk 23 or higher and compileSdk 35 or higher. Debug builds need minSdk 24.
• Kotlin 2.0 or newer, if the app uses Kotlin.
• A Free or Pro Buoy account key.
• A debug build for the first setup.

Buoy runs on phones, tablets and the emulator.

Next steps

• Quick Start: add the package and check your first web call.
• Installation: versions, account keys and every setup option.
• Physical Devices: connect a phone to Buoy Desktop.
• Release Builds: keep Buoy out of the builds you ship.