let package = Package(
    name: "my-package",
    products: [
        .library(name: "MyProduct", targets: ["MyTarget"]),
    ],
    dependencies: [
        .package(url: "https://source.skip.dev/skip-sentry.git", "0.0.0"..<"2.0.0"),
    ],
    targets: [
        .target(name: "MyTarget", dependencies: [
            .product(name: "SkipSentry", package: "skip-sentry")
        ])
    ]
)

import SkipSentry
@main struct MyApp: App {
    init() {
        SkipSentry.start(
            dsn: "https://examplePublicKey@o0.ingest.sentry.io/0",
            debug: false
        )
    }
    var body: some Scene {
        WindowGroup { ContentView() }
    }
}

SkipSentry.start { options in
    options.dsn = "https://examplePublicKey@o0.ingest.sentry.io/0"
    options.debug = false
    options.environment = "production"
    options.release = "1.0.0"
    options.dist = "1"
    options.sampleRate = 1.0                    // 0.0 to 1.0
    options.enableAutoSessionTracking = true
    options.sessionTrackingIntervalMillis = 30000
    options.attachStacktrace = true
    options.enableAppHangTracking = true         // iOS only
}

do {
    try riskyOperation()
} catch {
    SkipSentry.capture(error: error)
}

SkipSentry.capture(message: "User completed onboarding")
SkipSentry.capture(message: "Payment processing slow", level: .warning)
SkipSentry.capture(message: "Database connection lost", level: .error)

SkipSentry.addBreadcrumb(message: "User tapped checkout button")
SkipSentry.addBreadcrumb(
    message: "Navigated to payment screen",
    category: "navigation"
)
SkipSentry.addBreadcrumb(
    message: "API request failed with 500",
    category: "http",
    level: .error
)
// Clear all breadcrumbs
SkipSentry.clearBreadcrumbs()

SkipSentry.setUser(
    id: "user-12345",
    email: "user@example.com",
    username: "johndoe"
)
// Clear user on logout
SkipSentry.clearUser()

// Tags (searchable in Sentry UI)
SkipSentry.setTag(key: "page", value: "checkout")
SkipSentry.setTag(key: "feature_flag", value: "new_flow")
SkipSentry.removeTag(key: "page")
// Extras (additional context)
SkipSentry.setExtra(key: "response_time", value: "1200ms")
SkipSentry.setExtra(key: "cart_items", value: "3")
// Set the scope level
SkipSentry.setLevel(.warning)

SkipSentry.flush()                    // Default 5-second timeout
SkipSentry.flush(timeout: 10.0)       // Custom timeout

if SkipSentry.isEnabled {
    print("Sentry is active")
}
if SkipSentry.crashedLastRun {
    print("App crashed during the last run")
}

SkipSentry.close()

Warning

The following features are not yet available in the Skip cross-platform wrapper:

• Performance monitoring (transactions, spans) — Use the native Sentry SDKs directly via #if SKIP / #if !SKIP blocks for transaction tracing.
• Attachments — File attachments on events are not wrapped.
• User feedback dialog — The Sentry feedback widget is not wrapped.
• Session replay — Available on each platform's native SDK but not wrapped.
• Profiling — Not wrapped.
• Metrics — The custom metrics API is not wrapped.
• Feature flags — The addFeatureFlag API is not wrapped.

Note

Platform-specific differences:

• enableAppHangTracking is only available on iOS. It has no effect on Android.
• crashedLastRun is deprecated on iOS (use lastRunStatus via the native SDK for more detail). On Android, returns null if unknown, which is treated as false.
• capture(error:) on Android converts the error to a Java Throwable using Skip's standard error bridging. If the error already originates from a Java/Kotlin exception, it is passed directly. Otherwise, it is wrapped in an Exception with the error's localizedDescription.
• flush(timeout:) takes seconds on iOS but milliseconds on Android. The wrapper converts automatically.
• The start() methods on Android require an Android context (obtained from ProcessInfo.processInfo.androidContext), so they cannot be called in Robolectric unit tests.