Skip to main content

Swift Quickstart

From zero to your first event in about five minutes, for iOS, macOS, tvOS, watchOS, and visionOS apps.

1. Get an API key​

Sign up at app.mostlygoodmetrics.com and create a project. Copy the API key from the project's settings — it looks like mgm_proj_xxxx.

2. Install​

Use 1.0.1 or later for the SDK safety fixes; see the Swift SDK guide for actor-contract migration guidance.

In Xcode: File > Add Package Dependencies and enter:

https://github.com/Mostly-Good-Metrics/mostly-good-metrics-swift-sdk

Select Up to Next Major Version starting at 1.0.1. Or add it to your Package.swift:

dependencies: [
    .package(url: "https://github.com/Mostly-Good-Metrics/mostly-good-metrics-swift-sdk", from: "1.0.1")
]

Requires iOS 14+ / macOS 11+ / tvOS 14+ / watchOS 7+ and Swift 5.9+.

3. Initialize​

Configure the SDK once at app launch:

import SwiftUI
import MostlyGoodMetrics

@main
struct MyApp: App {
    init() {
        MostlyGoodMetrics.configure(apiKey: "mgm_proj_your_api_key")
    }

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

Using UIKit? Call configure in application(_:didFinishLaunchingWithOptions:) instead.

4. Track your first event​

MostlyGoodMetrics.track("first_event", properties: [
    "source": "quickstart"
])

Events are persisted to disk, batched, and flushed automatically (every 30 seconds and when the app backgrounds). The SDK also tracks $app_installed and $app_opened for you on launch, so you'll see events even before your first track call.

5. Verify in the dashboard​

Open your project at app.mostlygoodmetrics.com — first_event (and the automatic $app_opened) should appear within a few seconds of the SDK flushing. Backgrounding the app forces a flush.

If nothing shows up:

  • Enable debug logging: MostlyGoodMetrics.configure(with: MGMConfiguration(apiKey: "...", enableDebugLogging: true)) and watch the Xcode console
  • Check that the API key matches the project you're looking at

Next steps​