EXAMPLE

BurritoConsiderationClient/
├── BurritoConsiderationClientApp.swift  # App entry point with PostHog initialization
├── ContentView.swift                    # NavigationSplitView with sidebar routing
├── UserState.swift                      # @Observable user state with PostHog identify
├── LoginView.swift                      # Login form
├── DashboardView.swift                  # Welcome screen with dashboard_viewed tracking
├── BurritoView.swift                    # Burrito consideration with event capture
├── ProfileView.swift                    # Profile with journey progress and error trigger
└── Assets.xcassets/                     # Asset catalog

import PostHog

guard let POSTHOG_PROJECT_TOKEN = ProcessInfo.processInfo.environment["POSTHOG_PROJECT_TOKEN"],
      let POSTHOG_HOST = ProcessInfo.processInfo.environment["POSTHOG_HOST"] else {
    fatalError("Set POSTHOG_PROJECT_TOKEN and POSTHOG_HOST in the Xcode scheme environment variables.")
}

let config = PostHogConfig(apiKey: POSTHOG_PROJECT_TOKEN, host: POSTHOG_HOST)
config.captureApplicationLifecycleEvents = true
PostHogSDK.shared.setup(config)

PostHogSDK.shared.identify(username, userProperties: [
    "username": username,
])

.onAppear {
    PostHogSDK.shared.capture("dashboard_viewed", properties: [
        "username": userState.username ?? "unknown",
    ])
}

PostHogSDK.shared.capture("burrito_considered", properties: [
    "total_considerations": count,
    "username": username,
])

PostHogSDK.shared.capture("test_error_triggered", properties: [
    "error_type": "test",
    "error_message": error.localizedDescription,
])

PostHogSDK.shared.capture("user_logged_out")
PostHogSDK.shared.reset()

<?xml version="1.0" encoding="UTF-8"?>
<Workspace
   version = "1.0">
   <FileRef
      location = "self:">
   </FileRef>
</Workspace>

{
  "originHash" : "a2fc303e4b16c93c972ef2ddc4042cf91a9400e5d1639bc9740a80c0336cdd4e",
  "pins" : [
    {
      "identity" : "posthog-ios",
      "kind" : "remoteSourceControl",
      "location" : "https://github.com/PostHog/posthog-ios",
      "state" : {
        "revision" : "1783865d79a1cabc472cf2d56a1fe3f797417b52",
        "version" : "3.40.0"
      }
    }
  ],
  "version" : 3
}

<?xml version="1.0" encoding="UTF-8"?>
<Scheme
   LastUpgradeVersion = "2630"
   version = "1.7">
   <BuildAction
      parallelizeBuildables = "YES"
      buildImplicitDependencies = "YES"
      buildArchitectures = "Automatic">
      <BuildActionEntries>
         <BuildActionEntry
            buildForTesting = "YES"
            buildForRunning = "YES"
            buildForProfiling = "YES"
            buildForArchiving = "YES"
            buildForAnalyzing = "YES">
            <BuildableReference
               BuildableIdentifier = "primary"
               BlueprintIdentifier = "1F6BD9732F3520A100189B0B"
               BuildableName = "BurritoConsiderationClient.app"
               BlueprintName = "BurritoConsiderationClient"
               ReferencedContainer = "container:BurritoConsiderationClient.xcodeproj">
            </BuildableReference>
         </BuildActionEntry>
      </BuildActionEntries>
   </BuildAction>
   <TestAction
      buildConfiguration = "Debug"
      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
      shouldUseLaunchSchemeArgsEnv = "YES"
      shouldAutocreateTestPlan = "YES">

//
//  BurritoConsiderationClientApp.swift
//  BurritoConsiderationClient
//
//  Created by Danilo Campos on 2/5/26.
//

import SwiftUI
import PostHog

enum PostHogEnv: String {
    case apiKey = "POSTHOG_PROJECT_TOKEN"
    case host = "POSTHOG_HOST"

    var value: String {
        guard let value = ProcessInfo.processInfo.environment[rawValue] else {
            fatalError("Set \(rawValue) in the Xcode scheme environment variables.")
        }
        return value
    }
}

@main
struct BurritoConsiderationClientApp: App {
    @State private var userState = UserState()

    init() {
        let config = PostHogConfig(apiKey: PostHogEnv.apiKey.value, host: PostHogEnv.host.value)
        config.captureApplicationLifecycleEvents = true
        config.debug = true
        PostHogSDK.shared.setup(config)
    }

    var body: some Scene {
        WindowGroup {
            ContentView()
                .environment(userState)
        }
    }
}

//
//  BurritoView.swift
//  BurritoConsiderationClient
//

import SwiftUI
import PostHog

struct BurritoView: View {
    @Environment(UserState.self) private var userState
    @State private var showConfirmation = false

    var body: some View {
        VStack(spacing: 24) {
            Text("Take a moment to truly consider the potential of burritos.")
                .foregroundStyle(.secondary)
                .multilineTextAlignment(.center)

            Text("🌯")
                .font(.system(size: 80))

            Button("I Have Considered the Burrito Potential") {
                userState.burritoConsiderations += 1

                // PostHog: Capture burrito consideration event
                PostHogSDK.shared.capture("burrito_considered", properties: [
                    "total_considerations": userState.burritoConsiderations,
                    "username": userState.username ?? "unknown",
                ])

                showConfirmation = true
                Task {
                    try? await Task.sleep(for: .seconds(2))
                    showConfirmation = false
                }
            }
            .buttonStyle(.borderedProminent)
            .controlSize(.large)

            if showConfirmation {
                Text("Thank you for your consideration! Count: \(userState.burritoConsiderations)")
                    .foregroundStyle(.green)
                    .transition(.opacity)
            }

            Text("Total considerations: \(userState.burritoConsiderations)")
                .font(.title2)
                .padding(.top)
        }
        .padding()
        .animation(.default, value: showConfirmation)
        .navigationTitle("Burrito Consideration Zone")
    }
}

//
//  ContentView.swift
//  BurritoConsiderationClient
//
//  Created by Danilo Campos on 2/5/26.
//

import SwiftUI

enum Screen: CaseIterable, Identifiable {
    case dashboard, burrito, profile

    var id: Self { self }

    var title: String {
        switch self {
        case .dashboard: "Home"
        case .burrito: "Burrito"
        case .profile: "Profile"
        }
    }

    var icon: String {
        switch self {
        case .dashboard: "house"
        case .burrito: "fork.knife"
        case .profile: "person.circle"
        }
    }
}

struct ContentView: View {
    @Environment(UserState.self) private var userState
    @State private var selectedScreen: Screen? = .dashboard

    var body: some View {
        if userState.isLoggedIn {
            NavigationSplitView {
                List(Screen.allCases, selection: $selectedScreen) { screen in
                    Label(screen.title, systemImage: screen.icon)
                }
                .navigationTitle("Menu")
            } detail: {
                if let selectedScreen {
                    switch selectedScreen {
                    case .dashboard:
                        DashboardView()
                    case .burrito:
                        BurritoView()
                    case .profile:
                        ProfileView()
                    }
                } else {
                    Text("Select an item from the sidebar")
                        .foregroundStyle(.secondary)
                }
            }
        } else {
            NavigationStack {
                LoginView()
            }
        }
    }
}

//
//  DashboardView.swift
//  BurritoConsiderationClient
//

import SwiftUI
import PostHog

struct DashboardView: View {
    @Environment(UserState.self) private var userState

    var body: some View {
        VStack(spacing: 20) {
            Text("Welcome back, \(userState.username ?? "")!")
                .font(.largeTitle)
                .padding(.top, 40)

            Text("You are now logged in. Feel free to explore:")
                .foregroundStyle(.secondary)

            VStack(alignment: .leading, spacing: 12) {
                Label("Consider the potential of burritos", systemImage: "fork.knife")
                Label("View your profile and statistics", systemImage: "person.circle")
            }
            .padding()

            Spacer()
        }
        .padding()
        .navigationTitle("Home")
        .onAppear {
            // PostHog: Track dashboard view
            PostHogSDK.shared.capture("dashboard_viewed", properties: [
                "username": userState.username ?? "unknown",
            ])
        }
    }
}

//
//  LoginView.swift
//  BurritoConsiderationClient
//

import SwiftUI

struct LoginView: View {
    @Environment(UserState.self) private var userState
    @State private var username = ""
    @State private var password = ""
    @State private var showError = false

    var body: some View {
        Form {
            Section("Login") {
                TextField("Username", text: $username)
                    #if os(iOS)
                    .textInputAutocapitalization(.never)
                    #endif
                    .autocorrectionDisabled()

                SecureField("Password", text: $password)
            }

            Section {
                Button("Log In") {
                    if !userState.login(username: username, password: password) {
                        showError = true
                    }
                }
                .disabled(username.isEmpty || password.isEmpty)
            }
        }
        .formStyle(.grouped)
        .navigationTitle("Burrito Consideration")
        .alert("Login Failed", isPresented: $showError) {
            Button("OK", role: .cancel) { }
        } message: {
            Text("Please enter a valid username and password.")
        }
    }
}

//
//  ProfileView.swift
//  BurritoConsiderationClient
//

import SwiftUI
import PostHog

struct ProfileView: View {
    @Environment(UserState.self) private var userState

    private var journeyMessage: String {
        switch userState.burritoConsiderations {
        case 0:
            "You haven't considered any burritos yet. Visit the Burrito Consideration page to start!"
        case 1:
            "You've considered the burrito potential once. Keep going!"
        case 2...4:
            "You're getting the hang of burrito consideration!"
        case 5...9:
            "You're becoming a burrito consideration expert!"
        default:
            "You are a true burrito consideration master!"
        }
    }

    var body: some View {
        Form {
            Section("Your Information") {
                LabeledContent("Username", value: userState.username ?? "—")
                LabeledContent("Burrito Considerations", value: "\(userState.burritoConsiderations)")
            }

            Section("Your Burrito Journey") {
                Text(journeyMessage)
            }

            Section("Diagnostics") {
                Button("Trigger Test Error") {
                    let error = NSError(
                        domain: "com.posthog.BurritoConsiderationClient",
                        code: 42,
                        userInfo: [NSLocalizedDescriptionKey: "Test error triggered by user"]
                    )

                    // PostHog: Capture exception for error tracking
                    PostHogSDK.shared.capture("test_error_triggered", properties: [
                        "error_type": "test",
                        "error_message": error.localizedDescription,
                        "username": userState.username ?? "unknown",
                    ])
                }
            }

            Section {
                Button("Log Out", role: .destructive) {
                    userState.logout()
                }
            }
        }
        .formStyle(.grouped)
        .navigationTitle("Profile")
        .onAppear {
            // PostHog: Track profile view
            PostHogSDK.shared.capture("profile_viewed", properties: [
                "username": userState.username ?? "unknown",
            ])
        }
    }
}

//
//  UserState.swift
//  BurritoConsiderationClient
//

import Foundation
import PostHog

@Observable
class UserState {
    var username: String?
    var burritoConsiderations: Int = 0

    var isLoggedIn: Bool {
        username != nil
    }

    func login(username: String, password: String) -> Bool {
        // In a real app, validate credentials against a backend
        guard !username.isEmpty, !password.isEmpty else {
            return false
        }

        self.username = username
        self.burritoConsiderations = 0

        // PostHog: Identify user on login
        PostHogSDK.shared.identify(username, userProperties: [
            "username": username,
        ])

        // PostHog: Capture login event
        PostHogSDK.shared.capture("user_logged_in", properties: [
            "username": username,
        ])

        return true
    }

    func logout() {
        // PostHog: Capture logout event before reset
        PostHogSDK.shared.capture("user_logged_out")
        PostHogSDK.shared.reset()

        username = nil
        burritoConsiderations = 0
    }
}