# Overview

<!-- ::tool-film id="swift-trailer" -->

Buoy for Swift adds Buoy's developer tools to a native iOS app built with SwiftUI or UIKit. It is a separate SDK from the React Native packages: one Swift package, [Buoy-Swift](https://github.com/Buoy-gg/Buoy-Swift), that ships as a prebuilt, signed framework.

Swift support is in beta. The tools work on the device, in [Buoy Desktop](../desktop) and through the [MCP server](../mcp), but they do not match the React Native tools feature for feature. Each tool section in [Tools](./tools) lists what the native version leaves out.

## Start here

Let your coding agent install Buoy in your app:

<!-- ::agent-install platform="swift" where="docs-swift-overview" -->

To install by hand, follow the [Quick Start](./quick-start).

## What you get

One `import Buoy` brings in every tool:

| Tool | What it covers on iOS |
|---|---|
| [Network](./tools#network) | URLSession requests on default and ephemeral configurations, response overrides and throttling |
| [Console](./tools#console) | The app's native console output |
| [Storage](./tools#storage) | UserDefaults, registered keychain items and registered MMKV instances |
| [Env](./tools#env) | Values and validation rules you supply |
| [Impersonate](./tools#impersonate) | User search and impersonation headers on captured requests |
| [Image Overlay](./tools#image-overlay) | A design image laid over the running app |
| [Images](./tools#images) | Loading, failure, retry, blank and replacement states for `BuoyAsyncImage` |
| [Notifications](./tools#notifications) | Received notifications, responses, permissions and local test delivery |
| [Routes](./tools#routes) | Screens, route patterns and navigation |
| [Scenarios](./tools#scenarios) | Reviewed, repeatable app setups. Recording needs a development build |
| [Time Machine](./tools#time-machine) | Snapshots and live restore of UserDefaults and MMKV |
| [Events](./tools#events) | One timeline of network, storage and route activity |
| [Assets](./tools#assets) | Bundle resource sizes, duplicates and baselines |
| [Clock](../tools/clock) | Jump, freeze or speed up time read through `BuoyClock.now()` and Buoy's timers |
| [Lifecycle](../tools/lifecycle) | What the app does when people leave and come back |
| [Location](../tools/location) | Fake places, routes and geofences for `BuoyLocationProvider` |
| [Permissions](../tools/permissions) | Denied, blocked, limited and not-asked states for `BuoyPermissions` checks |
| [Bench](../tools/perf-monitor) | A floating speed HUD, plus benchmarks you can record and compare |
| [Highlight](../tools/highlight-updates) | Redraws of views marked with `.buoyTrackRenders` |
| [Debug Borders](../tools/debug-borders) | Outlines around views, to check layout |
| [Ask Buoy](../tools/ask-buoy) | Chat about the app in plain English and use its tools |

Tools for JavaScript stores, such as React Query, Redux, Zustand and Jotai, are not part of the Swift SDK. Neither are JS Top and Three. Sentry is not on Swift yet.

## Requirements

- An iOS app targeting iOS 16 or later, built with Xcode 16 or later. Apps can use Swift 5 or Swift 6 language mode.
- A Free or Pro Buoy account.
- A development build for the first setup.

Buoy runs on iOS devices and the iOS Simulator. Mac Catalyst and macOS are not supported.

## Next steps

- [Quick Start](./quick-start): add the package and check your first captured request.
- [Installation](./installation): package versions, sign-in and UIKit setup.
- [Physical Devices](./devices): connect an iPhone or iPad to Buoy Desktop.
- [Release Builds](./release-builds): keep Buoy out of the builds you ship.
