Quick start

Install DebugSwift

Add to your project in under two minutes. DEBUG builds only — never ship the debugger to App Store releases.

Start installing Full docs View on GitHub

Step 1

Add the dependency

Swift Package Manager is recommended for most projects. CocoaPods works too, with an optional XCFramework for faster builds.

Swift Package Manager

Recommended

In Xcode: File → Add Package Dependencies → paste the URL:

https://github.com/DebugSwift/DebugSwift

Or declare it in Package.swift:

package(url: "https://github.com/DebugSwift/DebugSwift.git", from: "1.0.0")

CocoaPods

Add to your Podfile:

pod 'DebugSwift'

XCFramework (faster builds)

Prebuilt binary — up to 50% faster compile times. Ideal for CI and large teams.

pod 'DebugSwift', :http => 'https://github.com/DebugSwift/DebugSwift/releases/latest/download/DebugSwift.xcframework.zip'

Apple Silicon: native arm64 simulator slices ship by default. Remove any EXCLUDED_ARCHS arm64 entries from your Podfile or build settings.

Step 2

Initialize in AppDelegate

One setup() call enables the floating debugger. Wrap everything in #if DEBUG so release builds strip the toolkit.

AppDelegate.swiftDEBUG only

import DebugSwift

#if DEBUG
let debugSwift = DebugSwift()

func application() -> Bool {
    debugSwift.setup()
    debugSwift.show()
    return true
}
#endif

Need filters, custom actions, or programmatic presentation? See configuration docs.

Step 3

Run and open the debugger

Build for the simulator or a device. The floating ball appears over your app — tap it or shake to toggle.

Build & run

Select a DEBUG scheme and launch on simulator or device.

Tap the ball

The floating overlay opens the full debugger UI in-app.

Shake to toggle

Optional gesture to show or hide without leaving your screen.

Requirements

DebugSwift runs in DEBUG configuration only. Release binaries exclude the toolkit.

iOS: iOS 14.0+
Swift: Swift 6.0+
Xcode: Xcode 16.0+
Simulator: Apple Silicon arm64

Debug inside your app. Ship with confidence.

Open-source in-app debugging toolkit for iOS. Inspect network traffic, monitor performance, browse resources, and debug UI, all from a floating overlay inside your app.

Get started Star on GitHub