Add push notification onboarding preview

Packages/iOS/CmuxMobileShellUI/Sources/CmuxMobileShellUI/OnboardingFlowView.swift

@@ -103,6 +103,8 @@ struct OnboardingFlowView: View {
             OnboardingAgentsView()
         case .notifications:
             OnboardingNotificationsView()
+        case .pushNotifications:
+            OnboardingPushNotificationsView()
         case .connect:
             OnboardingConnectionView(
                 phase: connectionPhase,
@@ -118,8 +120,10 @@ struct OnboardingFlowView: View {
             break
         case .notifications:
             showAgents()
-        case .connect:
+        case .pushNotifications:
             showNotifications()
+        case .connect:
+            showPushNotifications()
         }
     }
 
@@ -128,6 +132,8 @@ struct OnboardingFlowView: View {
         case .agents:
             showNotifications()
         case .notifications:
+            showPushNotifications()
+        case .pushNotifications:
             showConnection()
         case .connect:
             if isAuthenticated {
@@ -146,6 +152,10 @@ struct OnboardingFlowView: View {
         navigate(to: .notifications)
     }
 
+    private func showPushNotifications() {
+        navigate(to: .pushNotifications)
+    }
+
     private func showConnection() {
         navigate(to: .connect)
     }

Packages/iOS/CmuxMobileShellUI/Sources/CmuxMobileShellUI/OnboardingPushNotificationsView.swift

@@ -0,0 +1,72 @@
+#if os(iOS)
+import CmuxMobileSupport
+import SwiftUI
+import UIKit
+
+/// Sets context for the system notification prompt with an expanded group of
+/// notifications captured from iOS instead of approximating Apple's effects.
+struct OnboardingPushNotificationsView: View {
+    var body: some View {
+        ZStack {
+            Color.clear
+                .frame(width: 1, height: 1)
+                .accessibilityElement(children: .ignore)
+                .accessibilityLabel(title)
+                .accessibilityIdentifier("MobileOnboardingPushNotificationsScene")
+
+            OnboardingSceneContent(
+                title: title,
+                message: L10n.string(
+                    "mobile.onboarding.pushNotifications.body",
+                    defaultValue: "Get a push when work finishes or needs your input. Tap to open the right workspace."
+                ),
+                visual: OnboardingSystemNotificationPreview()
+            )
+        }
+    }
+
+    private var title: String {
+        L10n.string(
+            "mobile.onboarding.pushNotifications.title",
+            defaultValue: "Know when your agent needs you"
+        )
+    }
+}
+
+private struct OnboardingSystemNotificationPreview: View {
+    @Environment(\.locale) private var locale
+
+    var body: some View {
+        Group {
+            if let image {
+                Image(uiImage: image)
+                    .resizable()
+                    .scaledToFit()
+                    // 1,200 pixels is the native width of the @3x system capture.
+                    // Capping at its point width prevents iOS typography from scaling up.
+                    .frame(maxWidth: 400)
+            }
+        }
+        .frame(maxWidth: .infinity, maxHeight: .infinity)
+        .accessibilityElement(children: .ignore)
+        .accessibilityLabel(L10n.string(
+            "mobile.onboarding.pushPreview.accessibilityLabel",
+            defaultValue: "Three cmux notifications for completed work, failed checks, and requested input."
+        ))
+        .accessibilityIdentifier("MobileOnboardingPushPreview")
+    }
+
+    private var resourceName: String {
+        let language = OnboardingScreenshotLanguage.resolve(locale: locale)
+        return "Onboarding-push-\(language.rawValue)"
+    }
+
+    private var image: UIImage? {
+        guard let url = Bundle.module.url(
+            forResource: resourceName,
+            withExtension: "png"
+        ) else { return nil }
+        return UIImage(contentsOfFile: url.path)
+    }
+}
+#endif

Packages/iOS/CmuxMobileShellUI/Sources/CmuxMobileShellUI/OnboardingSceneChrome.swift

@@ -24,7 +24,7 @@ struct OnboardingSceneChrome: Equatable {
                 defaultValue: "Continue"
             )
             secondaryTitle = nil
-        case .notifications:
+        case .notifications, .pushNotifications:
             primaryTitle = L10n.string(
                 "mobile.onboarding.continue",
                 defaultValue: "Continue"

Packages/iOS/CmuxMobileShellUI/Sources/CmuxMobileShellUI/OnboardingStage.swift

@@ -2,6 +2,7 @@
 enum OnboardingStage: Int, CaseIterable, Hashable, Sendable {
     case agents
     case notifications
+    case pushNotifications
     case connect
 
     var position: Int { rawValue + 1 }
@@ -10,6 +11,7 @@ enum OnboardingStage: Int, CaseIterable, Hashable, Sendable {
         switch self {
         case .agents: "agents"
         case .notifications: "notifications"
+        case .pushNotifications: "push_notifications"
         case .connect: "connect"
         }
     }

Packages/iOS/CmuxMobileShellUI/Sources/CmuxMobileShellUI/ScreenshotNotificationPresenter.swift

@@ -1,7 +1,7 @@
 #if canImport(UIKit) && DEBUG
-import UserNotifications
+@preconcurrency import UserNotifications
 
-/// Drives a real iOS notification for the App Store notifications screenshot.
+/// Drives a realistic set of iOS notifications for screenshot capture.
 ///
 /// Safety: `UNUserNotificationCenter` retains the delegate and may call it from
 /// framework-managed concurrency contexts; this object guards its only mutable
@@ -16,24 +16,67 @@ final class ScreenshotNotificationPresenter: NSObject, UNUserNotificationCenterD
         center.delegate = self
         center.requestAuthorization(options: [.alert, .sound, .badge]) { granted, _ in
             guard granted else { return }
-            let content = UNMutableNotificationContent()
-            content.title = String(
-                localized: "mobile.screenshot.notification.title",
-                defaultValue: "Agent needs your input",
-                bundle: .main
-            )
-            content.body = String(
-                localized: "mobile.screenshot.notification.body",
-                defaultValue: "Claude is asking: which database should I use, Postgres or SQLite?",
-                bundle: .main
-            )
-            content.sound = .default
-            let trigger = UNTimeIntervalNotificationTrigger(timeInterval: 0.6, repeats: false)
-            center.add(UNNotificationRequest(
-                identifier: "cmux-screenshot-agent",
-                content: content,
-                trigger: trigger
-            ))
+            center.removeAllDeliveredNotifications()
+            center.removeAllPendingNotificationRequests()
+
+            let notifications = [
+                (
+                    identifier: "cmux-screenshot-input",
+                    title: String(
+                        localized: "mobile.screenshot.notification.input.title",
+                        defaultValue: "Codex needs your input",
+                        bundle: .main
+                    ),
+                    body: String(
+                        localized: "mobile.screenshot.notification.input.body",
+                        defaultValue: "Approve the command to keep work moving.",
+                        bundle: .main
+                    )
+                ),
+                (
+                    identifier: "cmux-screenshot-finished",
+                    title: String(
+                        localized: "mobile.screenshot.notification.finished.title",
+                        defaultValue: "Claude finished",
+                        bundle: .main
+                    ),
+                    body: String(
+                        localized: "mobile.screenshot.notification.finished.body",
+                        defaultValue: "The login crash fix is ready for review.",
+                        bundle: .main
+                    )
+                ),
+                (
+                    identifier: "cmux-screenshot-tests",
+                    title: String(
+                        localized: "mobile.screenshot.notification.tests.title",
+                        defaultValue: "Tests need attention",
+                        bundle: .main
+                    ),
+                    body: String(
+                        localized: "mobile.screenshot.notification.tests.body",
+                        defaultValue: "2 checks failed in cmux. Tap to open the workspace.",
+                        bundle: .main
+                    )
+                ),
+            ]
+
+            for (index, notification) in notifications.enumerated() {
+                let content = UNMutableNotificationContent()
+                content.title = notification.title
+                content.body = notification.body
+                content.sound = .default
+                content.threadIdentifier = "cmux-screenshot-agent-events"
+                let trigger = UNTimeIntervalNotificationTrigger(
+                    timeInterval: 0.7 * Double(index + 1),
+                    repeats: false
+                )
+                center.add(UNNotificationRequest(
+                    identifier: notification.identifier,
+                    content: content,
+                    trigger: trigger
+                ))
+            }
         }
     }