Adopt root-level tsswift app layout

Move the app payload under swift/ while keeping git, package.json, and .smartconfig.json at the repo root. This standardizes the Swift app setup so build, test, run, and watch workflows match the other repos.

swift/Sources/Features/Auth/LoginRootView.swift

@@ -0,0 +1,193 @@
+import SwiftUI
+
+private let loginAccent = AppTheme.accent
+
+struct LoginRootView: View {
+    @ObservedObject var model: AppViewModel
+    @Environment(\.horizontalSizeClass) private var horizontalSizeClass
+
+    var body: some View {
+        AppScrollScreen(compactLayout: compactLayout) {
+            LoginHeroPanel(model: model, compactLayout: compactLayout)
+            PairingConsoleCard(model: model, compactLayout: compactLayout)
+        }
+        .sheet(isPresented: $model.isScannerPresented) {
+            QRScannerSheet(
+                seededPayload: model.suggestedPairingPayload,
+                title: "Scan linking QR",
+                description: "Use the camera to scan the QR code from the web flow that activates this device as your passport.",
+                navigationTitle: "Scan Linking QR",
+                onCodeScanned: { payload in
+                    model.manualPairingPayload = payload
+                    Task {
+                        await model.signIn(with: payload, transport: .qr)
+                    }
+                }
+            )
+        }
+    }
+
+    private var compactLayout: Bool {
+        #if os(iOS)
+        horizontalSizeClass == .compact
+        #else
+        false
+        #endif
+    }
+}
+
+private struct LoginHeroPanel: View {
+    @ObservedObject var model: AppViewModel
+    let compactLayout: Bool
+
+    var body: some View {
+        AppPanel(compactLayout: compactLayout, radius: AppLayout.largeCardRadius) {
+            AppBadge(title: "Secure passport setup", tone: loginAccent)
+
+            Text("Turn this device into a passport for your idp.global identity")
+                .font(.system(size: compactLayout ? 28 : 36, weight: .bold, design: .rounded))
+                .lineLimit(3)
+
+            Text("Scan a linking QR code or paste a payload to activate this device as your passport for identity proofs and security alerts.")
+                .font(.subheadline)
+                .foregroundStyle(.secondary)
+
+            Divider()
+
+            VStack(alignment: .leading, spacing: 14) {
+                LoginFeatureRow(icon: "qrcode.viewfinder", title: "Scan a QR code from the web flow")
+                LoginFeatureRow(icon: "doc.text.viewfinder", title: "Paste a payload when you already have one")
+                LoginFeatureRow(icon: "iphone.gen3", title: "Handle identity checks and alerts here")
+            }
+
+            if model.isBootstrapping {
+                ProgressView("Preparing preview passport...")
+                    .tint(loginAccent)
+            }
+        }
+    }
+}
+
+private struct LoginFeatureRow: View {
+    let icon: String
+    let title: String
+
+    var body: some View {
+        HStack(alignment: .center, spacing: 12) {
+            Image(systemName: icon)
+                .font(.subheadline.weight(.semibold))
+                .foregroundStyle(loginAccent)
+                .frame(width: 28, height: 28)
+
+            Text(title)
+                .font(.headline)
+
+            Spacer(minLength: 0)
+        }
+    }
+}
+
+private struct PairingConsoleCard: View {
+    @ObservedObject var model: AppViewModel
+    let compactLayout: Bool
+
+    var body: some View {
+        AppSectionCard(title: "Set up passport", compactLayout: compactLayout) {
+            VStack(alignment: .leading, spacing: 8) {
+                Text("Link payload")
+                    .font(.subheadline.weight(.semibold))
+
+                AppTextEditorField(
+                    text: $model.manualPairingPayload,
+                    minHeight: compactLayout ? 132 : 150
+                )
+            }
+
+            if model.isAuthenticating {
+                HStack(spacing: 10) {
+                    ProgressView()
+                    Text("Activating this passport...")
+                        .foregroundStyle(.secondary)
+                }
+            }
+
+            Text("NFC, QR, and OTP proof methods become available after this passport is active.")
+                .font(.footnote)
+                .foregroundStyle(.secondary)
+
+            if compactLayout {
+                VStack(spacing: 12) {
+                    primaryButtons
+                    secondaryButtons
+                }
+            } else {
+                VStack(spacing: 12) {
+                    HStack(spacing: 12) {
+                        primaryButtons
+                    }
+
+                    secondaryButtons
+                }
+            }
+        }
+    }
+
+    @ViewBuilder
+    private var primaryButtons: some View {
+        Button {
+            model.isScannerPresented = true
+        } label: {
+            Label("Scan QR", systemImage: "qrcode.viewfinder")
+                .frame(maxWidth: .infinity)
+        }
+        .buttonStyle(.borderedProminent)
+        .controlSize(.large)
+    }
+
+    @ViewBuilder
+    private var secondaryButtons: some View {
+        if compactLayout {
+            VStack(spacing: 12) {
+                usePayloadButton
+                previewPayloadButton
+            }
+        } else {
+            HStack(spacing: 12) {
+                usePayloadButton
+                previewPayloadButton
+            }
+        }
+    }
+
+    private var usePayloadButton: some View {
+        Button {
+            Task {
+                await model.signInWithManualPayload()
+            }
+        } label: {
+            if model.isAuthenticating {
+                ProgressView()
+                    .frame(maxWidth: .infinity)
+            } else {
+                Label("Link with payload", systemImage: "arrow.right.circle")
+                    .frame(maxWidth: .infinity)
+            }
+        }
+        .buttonStyle(.bordered)
+        .controlSize(.large)
+        .disabled(model.isAuthenticating)
+    }
+
+    private var previewPayloadButton: some View {
+        Button {
+            Task {
+                await model.signInWithSuggestedPayload()
+            }
+        } label: {
+            Label("Use preview passport", systemImage: "wand.and.stars")
+                .frame(maxWidth: .infinity)
+        }
+        .buttonStyle(.bordered)
+        .controlSize(.large)
+    }
+}

swift/Sources/Features/Auth/NFCPairingView.swift

@@ -0,0 +1,296 @@
+import SwiftUI
+
+#if canImport(CoreLocation) && canImport(CoreNFC) && canImport(CryptoKit) && os(iOS)
+import CoreLocation
+import CoreNFC
+import CryptoKit
+
+@MainActor
+final class NFCIdentifyReader: NSObject, ObservableObject, @preconcurrency NFCNDEFReaderSessionDelegate {
+    @Published private(set) var helperText: String
+    @Published private(set) var isScanning = false
+    @Published private(set) var isSupported: Bool
+
+    var onAuthenticationRequestDetected: ((PairingAuthenticationRequest) -> Void)?
+    var onError: ((String) -> Void)?
+
+    private let signedGPSPositionProvider = SignedGPSPositionProvider()
+    private var session: NFCNDEFReaderSession?
+    private var isPreparingLocationProof = false
+
+    override init() {
+        let supported = NFCNDEFReaderSession.readingAvailable
+        _helperText = Published(initialValue: supported ? NFCIdentifyReader.idleHelperText : NFCIdentifyReader.unavailableHelperText)
+        _isSupported = Published(initialValue: supported)
+        super.init()
+    }
+
+    func beginScanning() {
+        refreshAvailability()
+
+        guard isSupported else {
+            onError?(Self.unavailableErrorMessage)
+            return
+        }
+
+        guard !isScanning else { return }
+
+        isScanning = true
+        isPreparingLocationProof = false
+        helperText = Self.scanningHelperText
+
+        let session = NFCNDEFReaderSession(delegate: self, queue: nil, invalidateAfterFirstRead: true)
+        session.alertMessage = "Hold your iPhone near the idp.global tag. A signed GPS position will be attached to this NFC identify action."
+        self.session = session
+        session.begin()
+    }
+
+    func readerSessionDidBecomeActive(_ session: NFCNDEFReaderSession) {
+        DispatchQueue.main.async {
+            self.helperText = Self.scanningHelperText
+        }
+    }
+
+    func readerSession(_ session: NFCNDEFReaderSession, didDetectNDEFs messages: [NFCNDEFMessage]) {
+        guard let payload = extractPayload(from: messages) else {
+            session.invalidate()
+            DispatchQueue.main.async {
+                self.finishScanning()
+                self.onError?(Self.invalidTagMessage)
+            }
+            return
+        }
+
+        DispatchQueue.main.async {
+            self.isPreparingLocationProof = true
+            self.helperText = Self.signingLocationHelperText
+
+            Task { @MainActor in
+                await self.completeAuthentication(for: payload)
+            }
+        }
+    }
+
+    func readerSession(_ session: NFCNDEFReaderSession, didInvalidateWithError error: Error) {
+        let nsError = error as NSError
+        let ignoredCodes = [200, 204] // User canceled, first tag read.
+
+        DispatchQueue.main.async {
+            self.session = nil
+        }
+
+        guard !(nsError.domain == NFCErrorDomain && ignoredCodes.contains(nsError.code)) else {
+            if !isPreparingLocationProof {
+                DispatchQueue.main.async {
+                    self.finishScanning()
+                }
+            }
+            return
+        }
+
+        DispatchQueue.main.async {
+            self.finishScanning()
+            self.onError?(Self.failureMessage(for: nsError))
+        }
+    }
+
+    @MainActor
+    private func completeAuthentication(for payload: String) async {
+        do {
+            let signedGPSPosition = try await signedGPSPositionProvider.currentSignedGPSPosition(for: payload)
+            let request = PairingAuthenticationRequest(
+                pairingPayload: payload,
+                transport: .nfc,
+                signedGPSPosition: signedGPSPosition
+            )
+            finishScanning()
+            onAuthenticationRequestDetected?(request)
+        } catch let error as AppError {
+            finishScanning()
+            onError?(error.errorDescription ?? Self.gpsSigningFailureMessage)
+        } catch {
+            finishScanning()
+            onError?(Self.gpsSigningFailureMessage)
+        }
+    }
+
+    private func finishScanning() {
+        session = nil
+        isPreparingLocationProof = false
+        isScanning = false
+        refreshAvailability()
+    }
+
+    private func refreshAvailability() {
+        let available = NFCNDEFReaderSession.readingAvailable
+        isSupported = available
+        if !isScanning {
+            helperText = available ? Self.idleHelperText : Self.unavailableHelperText
+        }
+    }
+
+    private func extractPayload(from messages: [NFCNDEFMessage]) -> String? {
+        for message in messages {
+            for record in message.records {
+                if let url = record.wellKnownTypeURIPayload() {
+                    return url.absoluteString
+                }
+
+                let (text, _) = record.wellKnownTypeTextPayload()
+                if let trimmed = text?.trimmingCharacters(in: .whitespacesAndNewlines),
+                   !trimmed.isEmpty {
+                    return trimmed
+                }
+
+                if let fallback = String(data: record.payload, encoding: .utf8)?
+                    .trimmingCharacters(in: .whitespacesAndNewlines),
+                   !fallback.isEmpty {
+                    return fallback
+                }
+            }
+        }
+
+        return nil
+    }
+
+    private static func failureMessage(for error: NSError) -> String {
+        if error.domain == NFCErrorDomain && error.code == 2 {
+            return "NFC identify is not permitted in this build. Check the NFC entitlement and privacy description."
+        }
+
+        return "NFC identify could not be completed on this device."
+    }
+
+    private static let idleHelperText = "Tap to identify with an NFC tag on supported iPhone hardware. A signed GPS position will be attached automatically."
+    private static let scanningHelperText = "Hold the top of your iPhone near the NFC tag until it is identified."
+    private static let signingLocationHelperText = "Tag detected. Capturing and signing the current GPS position for NFC identify."
+    private static let unavailableHelperText = "NFC identify is unavailable on this device."
+    private static let unavailableErrorMessage = "Tap to identify requires supported iPhone hardware with NFC enabled."
+    private static let invalidTagMessage = "The NFC tag did not contain a usable idp.global payload."
+    private static let gpsSigningFailureMessage = "The NFC tag was read, but the signed GPS position could not be attached."
+}
+
+@MainActor
+private final class SignedGPSPositionProvider: NSObject, @preconcurrency CLLocationManagerDelegate {
+    private var manager: CLLocationManager?
+    private var authorizationContinuation: CheckedContinuation<CLAuthorizationStatus, Never>?
+    private var locationContinuation: CheckedContinuation<CLLocation, Error>?
+
+    func currentSignedGPSPosition(for pairingPayload: String) async throws -> SignedGPSPosition {
+        let location = try await currentLocation()
+        return try sign(location: location, pairingPayload: pairingPayload)
+    }
+
+    private func currentLocation() async throws -> CLLocation {
+        let manager = CLLocationManager()
+        manager.delegate = self
+        manager.desiredAccuracy = kCLLocationAccuracyNearestTenMeters
+        manager.distanceFilter = kCLDistanceFilterNone
+        self.manager = manager
+
+        switch manager.authorizationStatus {
+        case .authorizedAlways, .authorizedWhenInUse:
+            break
+        case .notDetermined:
+            let status = await requestAuthorization(using: manager)
+            guard status == .authorizedAlways || status == .authorizedWhenInUse else {
+                throw AppError.locationPermissionDenied
+            }
+        case .denied, .restricted:
+            throw AppError.locationPermissionDenied
+        @unknown default:
+            throw AppError.locationUnavailable
+        }
+
+        return try await requestLocation(using: manager)
+    }
+
+    private func requestAuthorization(using manager: CLLocationManager) async -> CLAuthorizationStatus {
+        manager.requestWhenInUseAuthorization()
+        return await withCheckedContinuation { continuation in
+            authorizationContinuation = continuation
+        }
+    }
+
+    private func requestLocation(using manager: CLLocationManager) async throws -> CLLocation {
+        try await withCheckedThrowingContinuation { continuation in
+            locationContinuation = continuation
+            manager.requestLocation()
+        }
+    }
+
+    private func sign(location: CLLocation, pairingPayload: String) throws -> SignedGPSPosition {
+        let isFresh = abs(location.timestamp.timeIntervalSinceNow) <= 120
+        guard location.horizontalAccuracy >= 0,
+              isFresh else {
+            throw AppError.locationUnavailable
+        }
+
+        let unsignedPosition = SignedGPSPosition(
+            latitude: location.coordinate.latitude,
+            longitude: location.coordinate.longitude,
+            horizontalAccuracyMeters: location.horizontalAccuracy,
+            capturedAt: location.timestamp
+        )
+
+        let privateKey = P256.Signing.PrivateKey()
+        let signature = try privateKey.signature(for: unsignedPosition.signingPayload(for: pairingPayload))
+        return unsignedPosition.signed(
+            signatureData: signature.derRepresentation,
+            publicKeyData: privateKey.publicKey.x963Representation
+        )
+    }
+
+    func locationManagerDidChangeAuthorization(_ manager: CLLocationManager) {
+        guard let continuation = authorizationContinuation else { return }
+
+        let status = manager.authorizationStatus
+        guard status != .notDetermined else { return }
+
+        authorizationContinuation = nil
+        continuation.resume(returning: status)
+    }
+
+    func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) {
+        guard let continuation = locationContinuation,
+              let location = locations.last else {
+            return
+        }
+
+        authorizationContinuation = nil
+        locationContinuation = nil
+        self.manager = nil
+        continuation.resume(returning: location)
+    }
+
+    func locationManager(_ manager: CLLocationManager, didFailWithError error: Error) {
+        guard let continuation = locationContinuation else { return }
+
+        authorizationContinuation = nil
+        locationContinuation = nil
+        self.manager = nil
+
+        if let locationError = error as? CLError,
+           locationError.code == .denied {
+            continuation.resume(throwing: AppError.locationPermissionDenied)
+            return
+        }
+
+        continuation.resume(throwing: AppError.locationUnavailable)
+    }
+}
+#else
+@MainActor
+final class NFCIdentifyReader: NSObject, ObservableObject {
+    @Published private(set) var helperText = "NFC identify with a signed GPS position is available on supported iPhone hardware only."
+    @Published private(set) var isScanning = false
+    @Published private(set) var isSupported = false
+
+    var onAuthenticationRequestDetected: ((PairingAuthenticationRequest) -> Void)?
+    var onError: ((String) -> Void)?
+
+    func beginScanning() {
+        onError?("Tap to identify requires supported iPhone hardware with NFC and location access enabled.")
+    }
+}
+#endif

swift/Sources/Features/Auth/QRScannerView.swift

@@ -0,0 +1,418 @@
+import AVFoundation
+import Combine
+import SwiftUI
+#if os(iOS)
+import UIKit
+#elseif os(macOS)
+import AppKit
+#endif
+
+struct QRScannerSheet: View {
+    let seededPayload: String
+    let title: String
+    let description: String
+    let navigationTitleText: String
+    let onCodeScanned: (String) -> Void
+
+    @Environment(\.dismiss) private var dismiss
+    @Environment(\.horizontalSizeClass) private var horizontalSizeClass
+    @State private var manualFallback = ""
+
+    init(
+        seededPayload: String,
+        title: String = "Scan QR",
+        description: String = "Use the camera to scan an idp.global QR challenge.",
+        navigationTitle: String = "Scan QR",
+        onCodeScanned: @escaping (String) -> Void
+    ) {
+        self.seededPayload = seededPayload
+        self.title = title
+        self.description = description
+        self.navigationTitleText = navigationTitle
+        self.onCodeScanned = onCodeScanned
+    }
+
+    var body: some View {
+        NavigationStack {
+            AppScrollScreen(compactLayout: compactLayout) {
+                AppSectionCard(title: title, compactLayout: compactLayout) {
+                    Text(description)
+                        .font(.subheadline)
+                        .foregroundStyle(.secondary)
+
+                    LiveQRScannerView(onCodeScanned: onCodeScanned)
+                        .frame(minHeight: 340)
+                }
+
+                AppSectionCard(title: "Manual fallback", compactLayout: compactLayout) {
+                    AppTextEditorField(text: $manualFallback, minHeight: 120)
+
+                    if compactLayout {
+                        VStack(spacing: 12) {
+                            useFallbackButton
+                            useSeededButton
+                        }
+                    } else {
+                        HStack(spacing: 12) {
+                            useFallbackButton
+                            useSeededButton
+                        }
+                    }
+                }
+            }
+            .navigationTitle(navigationTitleText)
+            .toolbar {
+                ToolbarItem(placement: .cancellationAction) {
+                    Button("Close") {
+                        dismiss()
+                    }
+                }
+            }
+            .onAppear {
+                manualFallback = seededPayload
+            }
+        }
+    }
+
+    private var compactLayout: Bool {
+        #if os(iOS)
+        horizontalSizeClass == .compact
+        #else
+        false
+        #endif
+    }
+
+    private var useFallbackButton: some View {
+        Button {
+            let chosen = manualFallback.trimmingCharacters(in: .whitespacesAndNewlines)
+            onCodeScanned(chosen.isEmpty ? seededPayload : chosen)
+            dismiss()
+        } label: {
+            Label("Use payload", systemImage: "arrow.up.forward.square")
+                .frame(maxWidth: .infinity)
+        }
+        .buttonStyle(.borderedProminent)
+    }
+
+    private var useSeededButton: some View {
+        Button {
+            manualFallback = seededPayload
+        } label: {
+            Label("Reset sample", systemImage: "wand.and.rays")
+                .frame(maxWidth: .infinity)
+        }
+        .buttonStyle(.bordered)
+    }
+}
+
+private struct LiveQRScannerView: View {
+    let onCodeScanned: (String) -> Void
+
+    @StateObject private var scanner = QRScannerViewModel()
+
+    var body: some View {
+        ZStack(alignment: .bottomLeading) {
+            Group {
+                if scanner.isPreviewAvailable {
+                    ScannerPreview(session: scanner.captureSession)
+                        .clipShape(RoundedRectangle(cornerRadius: 30, style: .continuous))
+                } else {
+                    RoundedRectangle(cornerRadius: 30, style: .continuous)
+                        .fill(Color.black.opacity(0.86))
+
+                    VStack(alignment: .leading, spacing: 12) {
+                        Image(systemName: "video.slash.fill")
+                            .font(.system(size: 28, weight: .semibold))
+                            .foregroundStyle(.white)
+                        Text("Live camera preview unavailable")
+                            .font(.title3.weight(.semibold))
+                            .foregroundStyle(.white)
+                        Text(scanner.statusMessage)
+                            .foregroundStyle(.white.opacity(0.78))
+                    }
+                    .padding(24)
+                }
+            }
+
+            RoundedRectangle(cornerRadius: 30, style: .continuous)
+                .strokeBorder(.white.opacity(0.22), lineWidth: 1.5)
+
+            VStack(alignment: .leading, spacing: 8) {
+                Text("Camera Scanner")
+                    .font(.headline.weight(.semibold))
+                    .foregroundStyle(.white)
+                Text(scanner.statusMessage)
+                    .foregroundStyle(.white.opacity(0.84))
+            }
+            .padding(22)
+
+            ScanFrameOverlay()
+                .padding(40)
+        }
+        .task {
+            scanner.onCodeScanned = { payload in
+                onCodeScanned(payload)
+            }
+            await scanner.start()
+        }
+        .onDisappear {
+            scanner.stop()
+        }
+    }
+}
+
+private struct ScanFrameOverlay: View {
+    var body: some View {
+        GeometryReader { geometry in
+            let size = min(geometry.size.width, geometry.size.height) * 0.5
+
+            RoundedRectangle(cornerRadius: 28, style: .continuous)
+                .strokeBorder(.white.opacity(0.82), style: StrokeStyle(lineWidth: 3, dash: [10, 8]))
+                .frame(width: size, height: size)
+                .position(x: geometry.size.width / 2, y: geometry.size.height / 2)
+        }
+        .allowsHitTesting(false)
+    }
+}
+
+private final class QRScannerViewModel: NSObject, ObservableObject, AVCaptureMetadataOutputObjectsDelegate {
+    @Published var isPreviewAvailable = false
+    @Published var statusMessage = "Point the camera at the QR code from the idp.global web portal."
+
+    let captureSession = AVCaptureSession()
+
+    var onCodeScanned: ((String) -> Void)?
+
+    private let queue = DispatchQueue(label: "global.idp.qrscanner")
+    private var isConfigured = false
+    private var hasDeliveredCode = false
+
+    func start() async {
+        #if os(iOS) && targetEnvironment(simulator)
+        await MainActor.run {
+            isPreviewAvailable = false
+            statusMessage = "The iOS simulator has no live camera feed. Use the seeded payload below."
+        }
+        #else
+        #endif
+
+        #if !(os(iOS) && targetEnvironment(simulator))
+        let authorization = AVCaptureDevice.authorizationStatus(for: .video)
+        switch authorization {
+        case .authorized:
+            await configureIfNeeded()
+            startRunning()
+        case .notDetermined:
+            let granted = await requestCameraAccess()
+            await MainActor.run {
+                self.statusMessage = granted
+                    ? "Point the camera at the QR code from the idp.global web portal."
+                    : "Camera access was denied. Use the fallback payload below."
+            }
+            guard granted else { return }
+            await configureIfNeeded()
+            startRunning()
+        case .denied, .restricted:
+            await MainActor.run {
+                isPreviewAvailable = false
+                statusMessage = "Camera access is unavailable. Use the fallback payload below."
+            }
+        @unknown default:
+            await MainActor.run {
+                isPreviewAvailable = false
+                statusMessage = "Camera access could not be initialized on this device."
+            }
+        }
+        #endif
+    }
+
+    func stop() {
+        queue.async {
+            if self.captureSession.isRunning {
+                self.captureSession.stopRunning()
+            }
+        }
+    }
+
+    func metadataOutput(
+        _ output: AVCaptureMetadataOutput,
+        didOutput metadataObjects: [AVMetadataObject],
+        from connection: AVCaptureConnection
+    ) {
+        guard !hasDeliveredCode,
+              let readable = metadataObjects.first as? AVMetadataMachineReadableCodeObject,
+              readable.type == .qr,
+              let payload = readable.stringValue else {
+            return
+        }
+
+        hasDeliveredCode = true
+        stop()
+
+        #if os(iOS)
+        UINotificationFeedbackGenerator().notificationOccurred(.success)
+        #endif
+
+        DispatchQueue.main.async { [onCodeScanned] in
+            onCodeScanned?(payload)
+        }
+    }
+
+    private func requestCameraAccess() async -> Bool {
+        await withCheckedContinuation { continuation in
+            AVCaptureDevice.requestAccess(for: .video) { granted in
+                continuation.resume(returning: granted)
+            }
+        }
+    }
+
+    private func configureIfNeeded() async {
+        guard !isConfigured else {
+            await MainActor.run {
+                self.isPreviewAvailable = true
+            }
+            return
+        }
+
+        await withCheckedContinuation { (continuation: CheckedContinuation<Void, Never>) in
+            queue.async {
+                self.captureSession.beginConfiguration()
+                defer {
+                    self.captureSession.commitConfiguration()
+                    continuation.resume()
+                }
+
+                guard let device = AVCaptureDevice.default(for: .video) else {
+                    DispatchQueue.main.async {
+                        self.isPreviewAvailable = false
+                        self.statusMessage = "No compatible camera was found. Use the fallback payload below."
+                    }
+                    return
+                }
+
+                guard let input = try? AVCaptureDeviceInput(device: device) else {
+                    DispatchQueue.main.async {
+                        self.isPreviewAvailable = false
+                        self.statusMessage = "No compatible camera was found. Use the fallback payload below."
+                    }
+                    return
+                }
+
+                guard self.captureSession.canAddInput(input) else {
+                    DispatchQueue.main.async {
+                        self.isPreviewAvailable = false
+                        self.statusMessage = "No compatible camera was found. Use the fallback payload below."
+                    }
+                    return
+                }
+
+                self.captureSession.addInput(input)
+
+                let output = AVCaptureMetadataOutput()
+                guard self.captureSession.canAddOutput(output) else {
+                    self.captureSession.removeInput(input)
+                    DispatchQueue.main.async {
+                        self.isPreviewAvailable = false
+                        self.statusMessage = "Unable to configure QR metadata scanning on this device."
+                    }
+                    return
+                }
+
+                self.captureSession.addOutput(output)
+                output.setMetadataObjectsDelegate(self, queue: DispatchQueue.main)
+
+                let supportedTypes = output.availableMetadataObjectTypes
+                guard supportedTypes.contains(.qr) else {
+                    self.captureSession.removeOutput(output)
+                    self.captureSession.removeInput(input)
+                    DispatchQueue.main.async {
+                        self.isPreviewAvailable = false
+                        self.statusMessage = "This camera does not support QR metadata scanning. Use the fallback payload below."
+                    }
+                    return
+                }
+
+                output.metadataObjectTypes = [.qr]
+                self.isConfigured = true
+
+                DispatchQueue.main.async {
+                    self.isPreviewAvailable = true
+                    self.statusMessage = "Point the camera at the QR code from the idp.global web portal."
+                }
+            }
+        }
+    }
+
+    private func startRunning() {
+        queue.async {
+            guard !self.captureSession.isRunning else { return }
+            self.hasDeliveredCode = false
+            self.captureSession.startRunning()
+        }
+    }
+}
+
+extension QRScannerViewModel: @unchecked Sendable {}
+
+#if os(iOS)
+private struct ScannerPreview: UIViewRepresentable {
+    let session: AVCaptureSession
+
+    func makeUIView(context: Context) -> ScannerPreviewUIView {
+        let view = ScannerPreviewUIView()
+        view.previewLayer.session = session
+        view.previewLayer.videoGravity = .resizeAspectFill
+        return view
+    }
+
+    func updateUIView(_ uiView: ScannerPreviewUIView, context: Context) {
+        uiView.previewLayer.session = session
+    }
+}
+
+private final class ScannerPreviewUIView: UIView {
+    override class var layerClass: AnyClass {
+        AVCaptureVideoPreviewLayer.self
+    }
+
+    var previewLayer: AVCaptureVideoPreviewLayer {
+        layer as! AVCaptureVideoPreviewLayer
+    }
+}
+#elseif os(macOS)
+private struct ScannerPreview: NSViewRepresentable {
+    let session: AVCaptureSession
+
+    func makeNSView(context: Context) -> ScannerPreviewNSView {
+        let view = ScannerPreviewNSView()
+        view.attach(session: session)
+        return view
+    }
+
+    func updateNSView(_ nsView: ScannerPreviewNSView, context: Context) {
+        nsView.attach(session: session)
+    }
+}
+
+private final class ScannerPreviewNSView: NSView {
+    private var previewLayer: AVCaptureVideoPreviewLayer?
+
+    override init(frame frameRect: NSRect) {
+        super.init(frame: frameRect)
+        wantsLayer = true
+    }
+
+    required init?(coder: NSCoder) {
+        super.init(coder: coder)
+        wantsLayer = true
+    }
+
+    func attach(session: AVCaptureSession) {
+        let layer = previewLayer ?? AVCaptureVideoPreviewLayer(session: session)
+        layer.session = session
+        layer.videoGravity = .resizeAspectFill
+        self.layer = layer
+        previewLayer = layer
+    }
+}
+#endif

swift/Sources/Features/Home/HomeCards.swift

@@ -0,0 +1,330 @@
+import SwiftUI
+
+struct RequestList: View {
+    let requests: [ApprovalRequest]
+    let compactLayout: Bool
+    let activeRequestID: ApprovalRequest.ID?
+    let onApprove: ((ApprovalRequest) -> Void)?
+    let onReject: ((ApprovalRequest) -> Void)?
+    let onOpenRequest: (ApprovalRequest) -> Void
+
+    var body: some View {
+        VStack(spacing: 14) {
+            ForEach(requests) { request in
+                RequestCard(
+                    request: request,
+                    compactLayout: compactLayout,
+                    isBusy: activeRequestID == request.id,
+                    onApprove: onApprove == nil ? nil : { onApprove?(request) },
+                    onReject: onReject == nil ? nil : { onReject?(request) },
+                    onOpenRequest: { onOpenRequest(request) }
+                )
+            }
+        }
+    }
+}
+
+private struct RequestCard: View {
+    let request: ApprovalRequest
+    let compactLayout: Bool
+    let isBusy: Bool
+    let onApprove: (() -> Void)?
+    let onReject: (() -> Void)?
+    let onOpenRequest: () -> Void
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: 12) {
+            HStack(alignment: .top, spacing: 12) {
+                Image(systemName: request.kind.systemImage)
+                    .font(.headline)
+                    .foregroundStyle(requestAccent)
+                    .frame(width: 28, height: 28)
+
+                VStack(alignment: .leading, spacing: 4) {
+                    Text(request.title)
+                        .font(.headline)
+                        .multilineTextAlignment(.leading)
+
+                    Text(request.source)
+                        .font(.subheadline)
+                        .foregroundStyle(.secondary)
+                        .lineLimit(1)
+                }
+
+                Spacer(minLength: 0)
+
+                AppStatusTag(title: request.status.title, tone: statusTone)
+            }
+
+            Text(request.subtitle)
+                .font(.subheadline)
+                .foregroundStyle(.secondary)
+                .lineLimit(2)
+
+            HStack(spacing: 8) {
+                AppStatusTag(title: request.risk.title, tone: request.risk == .routine ? dashboardAccent : .orange)
+                Text(request.scopeSummary)
+                    .font(.footnote)
+                    .foregroundStyle(.secondary)
+                Spacer(minLength: 0)
+                Text(request.createdAt, style: .relative)
+                    .font(.footnote)
+                    .foregroundStyle(.secondary)
+            }
+
+            if !request.scopes.isEmpty {
+                Text("Proof details: \(request.scopes.joined(separator: ", "))")
+                    .font(.footnote)
+                    .foregroundStyle(.secondary)
+                    .lineLimit(2)
+            }
+
+            controls
+        }
+        .padding(compactLayout ? 18 : 20)
+        .appSurface(radius: 24)
+    }
+
+    @ViewBuilder
+    private var controls: some View {
+        if compactLayout {
+            VStack(alignment: .leading, spacing: 10) {
+                reviewButton
+                decisionButtons
+            }
+        } else {
+            HStack(spacing: 12) {
+                reviewButton
+                Spacer(minLength: 0)
+                decisionButtons
+            }
+        }
+    }
+
+    private var reviewButton: some View {
+        Button {
+            onOpenRequest()
+        } label: {
+            Label("Review proof", systemImage: "arrow.up.forward.app")
+        }
+        .buttonStyle(.bordered)
+    }
+
+    @ViewBuilder
+    private var decisionButtons: some View {
+        if request.status == .pending, let onApprove, let onReject {
+            Button {
+                onApprove()
+            } label: {
+                if isBusy {
+                    ProgressView()
+                } else {
+                    Label("Verify", systemImage: "checkmark.circle.fill")
+                }
+            }
+            .buttonStyle(.borderedProminent)
+            .disabled(isBusy)
+
+            Button(role: .destructive) {
+                onReject()
+            } label: {
+                Label("Decline", systemImage: "xmark.circle.fill")
+            }
+            .buttonStyle(.bordered)
+            .disabled(isBusy)
+        }
+    }
+
+    private var statusTone: Color {
+        switch request.status {
+        case .pending:
+            .orange
+        case .approved:
+            .green
+        case .rejected:
+            .red
+        }
+    }
+
+    private var requestAccent: Color {
+        switch request.status {
+        case .approved:
+            .green
+        case .rejected:
+            .red
+        case .pending:
+            request.risk == .routine ? dashboardAccent : .orange
+        }
+    }
+}
+
+struct NotificationList: View {
+    let notifications: [AppNotification]
+    let compactLayout: Bool
+    let onMarkRead: (AppNotification) -> Void
+
+    var body: some View {
+        VStack(spacing: 14) {
+            ForEach(notifications) { notification in
+                NotificationCard(
+                    notification: notification,
+                    compactLayout: compactLayout,
+                    onMarkRead: { onMarkRead(notification) }
+                )
+            }
+        }
+    }
+}
+
+private struct NotificationCard: View {
+    let notification: AppNotification
+    let compactLayout: Bool
+    let onMarkRead: () -> Void
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: 10) {
+            HStack(alignment: .top, spacing: 12) {
+                Image(systemName: notification.kind.systemImage)
+                    .font(.headline)
+                    .foregroundStyle(accentColor)
+                    .frame(width: 28, height: 28)
+
+                VStack(alignment: .leading, spacing: 4) {
+                    Text(notification.title)
+                        .font(.headline)
+
+                    HStack(spacing: 8) {
+                        AppStatusTag(title: notification.kind.title, tone: accentColor)
+                        if notification.isUnread {
+                            AppStatusTag(title: "Unread", tone: .orange)
+                        }
+                    }
+                }
+
+                Spacer(minLength: 0)
+            }
+
+            Text(notification.message)
+                .font(.subheadline)
+                .foregroundStyle(.secondary)
+                .fixedSize(horizontal: false, vertical: true)
+
+            if compactLayout {
+                VStack(alignment: .leading, spacing: 10) {
+                    timestamp
+                    if notification.isUnread {
+                        markReadButton
+                    }
+                }
+            } else {
+                HStack {
+                    timestamp
+                    Spacer(minLength: 0)
+                    if notification.isUnread {
+                        markReadButton
+                    }
+                }
+            }
+        }
+        .padding(compactLayout ? 18 : 20)
+        .appSurface(radius: 24)
+    }
+
+    private var timestamp: some View {
+        Text(notification.sentAt.formatted(date: .abbreviated, time: .shortened))
+            .font(.footnote)
+            .foregroundStyle(.secondary)
+    }
+
+    private var markReadButton: some View {
+        Button {
+            onMarkRead()
+        } label: {
+            Label("Mark read", systemImage: "checkmark")
+        }
+        .buttonStyle(.bordered)
+    }
+
+    private var accentColor: Color {
+        switch notification.kind {
+        case .approval:
+            .green
+        case .security:
+            .orange
+        case .system:
+            .blue
+        }
+    }
+}
+
+struct NotificationBellButton: View {
+    @ObservedObject var model: AppViewModel
+
+    var body: some View {
+        Button {
+            model.isNotificationCenterPresented = true
+        } label: {
+            Image(systemName: imageName)
+                .font(.headline)
+                .foregroundStyle(iconTone)
+                .frame(width: 28, height: 28, alignment: .center)
+                .background(alignment: .center) {
+                    #if os(iOS)
+                    GeometryReader { proxy in
+                        Color.clear
+                            .preference(key: NotificationBellFrameKey.self, value: proxy.frame(in: .global))
+                    }
+                    #endif
+                }
+        }
+        .accessibilityLabel("Notifications")
+    }
+
+    private var imageName: String {
+        #if os(iOS)
+        model.unreadNotificationCount == 0 ? "bell" : "bell.fill"
+        #else
+        model.unreadNotificationCount == 0 ? "bell" : "bell.badge.fill"
+        #endif
+    }
+
+    private var iconTone: some ShapeStyle {
+        model.unreadNotificationCount == 0 ? Color.primary : dashboardAccent
+    }
+}
+
+struct NotificationCenterSheet: View {
+    @ObservedObject var model: AppViewModel
+    @Environment(\.dismiss) private var dismiss
+    @Environment(\.horizontalSizeClass) private var horizontalSizeClass
+
+    var body: some View {
+        NavigationStack {
+            AppScrollScreen(
+                compactLayout: compactLayout,
+                bottomPadding: compactLayout ? AppLayout.compactBottomDockPadding : AppLayout.regularBottomPadding
+            ) {
+                NotificationsPanel(model: model, compactLayout: compactLayout)
+            }
+            .navigationTitle("Notifications")
+            .toolbar {
+                ToolbarItem(placement: .cancellationAction) {
+                    Button("Done") {
+                        dismiss()
+                    }
+                }
+            }
+        }
+        #if os(iOS)
+        .presentationDetents(compactLayout ? [.large] : [.medium, .large])
+        #endif
+    }
+
+    private var compactLayout: Bool {
+        #if os(iOS)
+        horizontalSizeClass == .compact
+        #else
+        false
+        #endif
+    }
+}

swift/Sources/Features/Home/HomePanels.swift

@@ -0,0 +1,317 @@
+import SwiftUI
+
+struct OverviewPanel: View {
+    @ObservedObject var model: AppViewModel
+    let compactLayout: Bool
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: AppLayout.sectionSpacing(for: compactLayout)) {
+            if let profile = model.profile, let session = model.session {
+                OverviewHero(
+                    profile: profile,
+                    session: session,
+                    pendingCount: model.pendingRequests.count,
+                    unreadCount: model.unreadNotificationCount,
+                    compactLayout: compactLayout
+                )
+            }
+        }
+    }
+}
+
+struct RequestsPanel: View {
+    @ObservedObject var model: AppViewModel
+    let compactLayout: Bool
+    let onOpenRequest: (ApprovalRequest) -> Void
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: AppLayout.sectionSpacing(for: compactLayout)) {
+            if model.requests.isEmpty {
+                AppPanel(compactLayout: compactLayout) {
+                    EmptyStateCopy(
+                        title: "No checks waiting",
+                        systemImage: "checkmark.circle",
+                        message: "Identity proof requests from sites and devices appear here."
+                    )
+                }
+            } else {
+                RequestList(
+                    requests: model.requests,
+                    compactLayout: compactLayout,
+                    activeRequestID: model.activeRequestID,
+                    onApprove: { request in
+                        Task { await model.approve(request) }
+                    },
+                    onReject: { request in
+                        Task { await model.reject(request) }
+                    },
+                    onOpenRequest: onOpenRequest
+                )
+            }
+        }
+    }
+}
+
+struct ActivityPanel: View {
+    @ObservedObject var model: AppViewModel
+    let compactLayout: Bool
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: AppLayout.sectionSpacing(for: compactLayout)) {
+            if model.notifications.isEmpty {
+                AppPanel(compactLayout: compactLayout) {
+                    EmptyStateCopy(
+                        title: "No proof activity yet",
+                        systemImage: "clock.badge.xmark",
+                        message: "Identity proofs and security events will appear here."
+                    )
+                }
+            } else {
+                NotificationList(
+                    notifications: model.notifications,
+                    compactLayout: compactLayout,
+                    onMarkRead: { notification in
+                        Task { await model.markNotificationRead(notification) }
+                    }
+                )
+            }
+        }
+    }
+}
+
+struct NotificationsPanel: View {
+    @ObservedObject var model: AppViewModel
+    let compactLayout: Bool
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: AppLayout.sectionSpacing(for: compactLayout)) {
+            AppSectionCard(title: "Delivery", compactLayout: compactLayout) {
+                NotificationPermissionSummary(model: model, compactLayout: compactLayout)
+            }
+
+            AppSectionCard(title: "Alerts", compactLayout: compactLayout) {
+                if model.notifications.isEmpty {
+                    EmptyStateCopy(
+                        title: "No alerts yet",
+                        systemImage: "bell.slash",
+                        message: "New passport and identity-proof alerts will accumulate here."
+                    )
+                } else {
+                    NotificationList(
+                        notifications: model.notifications,
+                        compactLayout: compactLayout,
+                        onMarkRead: { notification in
+                            Task { await model.markNotificationRead(notification) }
+                        }
+                    )
+                }
+            }
+        }
+    }
+}
+
+struct AccountPanel: View {
+    @ObservedObject var model: AppViewModel
+    let compactLayout: Bool
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: AppLayout.sectionSpacing(for: compactLayout)) {
+            if let profile = model.profile, let session = model.session {
+                AccountHero(profile: profile, session: session, compactLayout: compactLayout)
+
+                AppSectionCard(title: "Session", compactLayout: compactLayout) {
+                    AccountFactsGrid(profile: profile, session: session, compactLayout: compactLayout)
+                }
+            }
+
+            AppSectionCard(title: "Pairing payload", compactLayout: compactLayout) {
+                AppTextSurface(text: model.suggestedPairingPayload, monospaced: true)
+            }
+
+            AppSectionCard(title: "Actions", compactLayout: compactLayout) {
+                Button(role: .destructive) {
+                    model.signOut()
+                } label: {
+                    Label("Sign Out", systemImage: "rectangle.portrait.and.arrow.right")
+                }
+                .buttonStyle(.bordered)
+            }
+        }
+    }
+}
+
+private struct OverviewHero: View {
+    let profile: MemberProfile
+    let session: AuthSession
+    let pendingCount: Int
+    let unreadCount: Int
+    let compactLayout: Bool
+
+    private var detailColumns: [GridItem] {
+        Array(repeating: GridItem(.flexible(), spacing: 16), count: compactLayout ? 1 : 2)
+    }
+
+    private var metricColumns: [GridItem] {
+        Array(repeating: GridItem(.flexible(), spacing: 16), count: 3)
+    }
+
+    var body: some View {
+        AppPanel(compactLayout: compactLayout, radius: AppLayout.largeCardRadius) {
+            AppBadge(title: "Digital passport", tone: dashboardAccent)
+
+            VStack(alignment: .leading, spacing: 6) {
+                Text(profile.name)
+                    .font(.system(size: compactLayout ? 30 : 38, weight: .bold, design: .rounded))
+                    .lineLimit(2)
+
+                Text("\(profile.handle) • \(profile.organization)")
+                    .font(.subheadline)
+                    .foregroundStyle(.secondary)
+            }
+
+            HStack(spacing: 8) {
+                AppStatusTag(title: "Passport active", tone: dashboardAccent)
+                AppStatusTag(title: session.pairingTransport.title, tone: dashboardGold)
+            }
+
+            Divider()
+
+            LazyVGrid(columns: detailColumns, alignment: .leading, spacing: 16) {
+                AppKeyValue(label: "Device", value: session.deviceName)
+                AppKeyValue(label: "Origin", value: session.originHost, monospaced: true)
+                AppKeyValue(label: "Linked", value: session.pairedAt.formatted(date: .abbreviated, time: .shortened))
+                AppKeyValue(label: "Token", value: "...\(session.tokenPreview)", monospaced: true)
+            }
+
+            Divider()
+
+            LazyVGrid(columns: metricColumns, alignment: .leading, spacing: 16) {
+                AppMetric(title: "Pending", value: "\(pendingCount)")
+                AppMetric(title: "Alerts", value: "\(unreadCount)")
+                AppMetric(title: "Devices", value: "\(profile.deviceCount)")
+            }
+        }
+    }
+}
+
+private struct NotificationPermissionSummary: View {
+    @ObservedObject var model: AppViewModel
+    let compactLayout: Bool
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: 14) {
+            HStack(alignment: .top, spacing: 12) {
+                Image(systemName: model.notificationPermission.systemImage)
+                    .font(.headline)
+                    .foregroundStyle(dashboardAccent)
+                    .frame(width: 28, height: 28)
+
+                VStack(alignment: .leading, spacing: 4) {
+                    Text(model.notificationPermission.title)
+                        .font(.headline)
+                    Text(model.notificationPermission.summary)
+                        .font(.subheadline)
+                        .foregroundStyle(.secondary)
+                }
+            }
+
+            if compactLayout {
+                VStack(alignment: .leading, spacing: 12) {
+                    permissionButtons
+                }
+            } else {
+                HStack(spacing: 12) {
+                    permissionButtons
+                }
+            }
+        }
+    }
+
+    @ViewBuilder
+    private var permissionButtons: some View {
+        Button {
+            Task { await model.requestNotificationAccess() }
+        } label: {
+            Label("Enable notifications", systemImage: "bell.and.waves.left.and.right.fill")
+                .frame(maxWidth: .infinity)
+        }
+        .buttonStyle(.borderedProminent)
+
+        Button {
+            Task { await model.sendTestNotification() }
+        } label: {
+            Label("Send test alert", systemImage: "paperplane.fill")
+                .frame(maxWidth: .infinity)
+        }
+        .buttonStyle(.bordered)
+    }
+}
+
+private struct AccountHero: View {
+    let profile: MemberProfile
+    let session: AuthSession
+    let compactLayout: Bool
+
+    var body: some View {
+        AppPanel(compactLayout: compactLayout, radius: AppLayout.largeCardRadius) {
+            AppBadge(title: "Account", tone: dashboardAccent)
+
+            Text(profile.name)
+                .font(.system(size: compactLayout ? 28 : 34, weight: .bold, design: .rounded))
+                .lineLimit(2)
+
+            Text(profile.handle)
+                .font(.headline)
+                .foregroundStyle(.secondary)
+
+            Text("Active client: \(session.deviceName)")
+                .font(.subheadline)
+                .foregroundStyle(.secondary)
+        }
+    }
+}
+
+private struct AccountFactsGrid: View {
+    let profile: MemberProfile
+    let session: AuthSession
+    let compactLayout: Bool
+
+    private var columns: [GridItem] {
+        Array(repeating: GridItem(.flexible(), spacing: 16), count: compactLayout ? 1 : 2)
+    }
+
+    var body: some View {
+        LazyVGrid(columns: columns, alignment: .leading, spacing: 16) {
+            AppKeyValue(label: "Organization", value: profile.organization)
+            AppKeyValue(label: "Origin", value: session.originHost, monospaced: true)
+            AppKeyValue(label: "Linked At", value: session.pairedAt.formatted(date: .abbreviated, time: .shortened))
+            AppKeyValue(label: "Method", value: session.pairingTransport.title)
+            AppKeyValue(label: "Token", value: "...\(session.tokenPreview)", monospaced: true)
+            AppKeyValue(label: "Recovery", value: profile.recoverySummary)
+            if let signedGPSPosition = session.signedGPSPosition {
+                AppKeyValue(
+                    label: "Signed GPS",
+                    value: "\(signedGPSPosition.coordinateSummary) \(signedGPSPosition.accuracySummary)",
+                    monospaced: true
+                )
+            }
+            AppKeyValue(label: "Trusted Devices", value: "\(profile.deviceCount)")
+        }
+    }
+}
+
+private struct EmptyStateCopy: View {
+    let title: String
+    let systemImage: String
+    let message: String
+
+    var body: some View {
+        ContentUnavailableView(
+            title,
+            systemImage: systemImage,
+            description: Text(message)
+        )
+        .frame(maxWidth: .infinity)
+        .padding(.vertical, 10)
+    }
+}

swift/Sources/Features/Home/HomeRootView.swift

@@ -0,0 +1,356 @@
+import SwiftUI
+
+let dashboardAccent = AppTheme.accent
+let dashboardGold = AppTheme.warmAccent
+
+extension View {
+    @ViewBuilder
+    func inlineNavigationTitleOnIOS() -> some View {
+        #if os(iOS)
+        navigationBarTitleDisplayMode(.inline)
+        #else
+        self
+        #endif
+    }
+
+    @ViewBuilder
+    func cleanTabBarOnIOS() -> some View {
+        #if os(iOS)
+        toolbarBackground(.visible, for: .tabBar)
+            .toolbarBackground(AppTheme.chromeFill, for: .tabBar)
+        #else
+        self
+        #endif
+    }
+}
+
+struct HomeRootView: View {
+    @ObservedObject var model: AppViewModel
+    @State private var notificationBellFrame: CGRect?
+
+    var body: some View {
+        Group {
+            if usesCompactNavigation {
+                CompactHomeContainer(model: model)
+            } else {
+                RegularHomeContainer(model: model)
+            }
+        }
+        .onPreferenceChange(NotificationBellFrameKey.self) { notificationBellFrame = $0 }
+        .overlay(alignment: .topLeading) {
+            if usesCompactNavigation {
+                NotificationBellBadgeOverlay(
+                    unreadCount: model.unreadNotificationCount,
+                    bellFrame: notificationBellFrame
+                )
+                .ignoresSafeArea()
+            }
+        }
+        .sheet(isPresented: $model.isNotificationCenterPresented) {
+            NotificationCenterSheet(model: model)
+        }
+    }
+
+    private var usesCompactNavigation: Bool {
+        #if os(iOS)
+        true
+        #else
+        false
+        #endif
+    }
+}
+
+private struct CompactHomeContainer: View {
+    @ObservedObject var model: AppViewModel
+    @Environment(\.horizontalSizeClass) private var horizontalSizeClass
+
+    var body: some View {
+        TabView(selection: $model.selectedSection) {
+            ForEach(AppSection.allCases) { section in
+                NavigationStack {
+                    HomeSectionScreen(model: model, section: section, compactLayout: compactLayout)
+                        .navigationTitle(section.title)
+                        .inlineNavigationTitleOnIOS()
+                        .toolbar {
+                            DashboardToolbar(model: model)
+                        }
+                }
+                .tag(section)
+                .tabItem {
+                    Label(section.title, systemImage: section.systemImage)
+                }
+            }
+        }
+        .cleanTabBarOnIOS()
+    }
+
+    private var compactLayout: Bool {
+        #if os(iOS)
+        horizontalSizeClass == .compact
+        #else
+        false
+        #endif
+    }
+}
+
+private struct RegularHomeContainer: View {
+    @ObservedObject var model: AppViewModel
+
+    var body: some View {
+        NavigationSplitView {
+            Sidebar(model: model)
+                .navigationSplitViewColumnWidth(min: 240, ideal: 280, max: 320)
+        } detail: {
+            HomeSectionScreen(model: model, section: model.selectedSection, compactLayout: false)
+                .navigationTitle(model.selectedSection.title)
+                .toolbar {
+                    DashboardToolbar(model: model)
+                }
+        }
+        .navigationSplitViewStyle(.balanced)
+    }
+}
+
+private struct DashboardToolbar: ToolbarContent {
+    @ObservedObject var model: AppViewModel
+
+    var body: some ToolbarContent {
+        ToolbarItemGroup(placement: .primaryAction) {
+            NotificationBellButton(model: model)
+        }
+    }
+}
+
+struct NotificationBellFrameKey: PreferenceKey {
+    static var defaultValue: CGRect? = nil
+
+    static func reduce(value: inout CGRect?, nextValue: () -> CGRect?) {
+        value = nextValue() ?? value
+    }
+}
+
+private struct NotificationBellBadgeOverlay: View {
+    let unreadCount: Int
+    let bellFrame: CGRect?
+
+    var body: some View {
+        GeometryReader { proxy in
+            if unreadCount > 0, let bellFrame {
+                let rootFrame = proxy.frame(in: .global)
+
+                Text("\(min(unreadCount, 9))")
+                    .font(.caption2.weight(.bold))
+                    .foregroundStyle(.white)
+                    .frame(minWidth: 18, minHeight: 18)
+                    .padding(.horizontal, 3)
+                    .background(Color.orange, in: Capsule())
+                    .position(
+                        x: bellFrame.maxX - rootFrame.minX - 2,
+                        y: bellFrame.minY - rootFrame.minY + 2
+                    )
+            }
+        }
+        .allowsHitTesting(false)
+    }
+}
+
+private struct HomeSectionScreen: View {
+    @ObservedObject var model: AppViewModel
+    let section: AppSection
+    let compactLayout: Bool
+
+    @State private var focusedRequest: ApprovalRequest?
+    @State private var isOTPPresented = false
+    @StateObject private var identifyReader = NFCIdentifyReader()
+
+    var body: some View {
+        AppScrollScreen(
+            compactLayout: compactLayout,
+            bottomPadding: compactLayout ? AppLayout.compactBottomDockPadding : AppLayout.regularBottomPadding
+        ) {
+            HomeTopActions(
+                model: model,
+                identifyReader: identifyReader,
+                onScanQR: { model.isScannerPresented = true },
+                onShowOTP: { isOTPPresented = true }
+            )
+
+            switch section {
+            case .overview:
+                OverviewPanel(model: model, compactLayout: compactLayout)
+            case .requests:
+                RequestsPanel(model: model, compactLayout: compactLayout, onOpenRequest: { focusedRequest = $0 })
+            case .activity:
+                ActivityPanel(model: model, compactLayout: compactLayout)
+            case .account:
+                AccountPanel(model: model, compactLayout: compactLayout)
+            }
+        }
+        .task {
+            identifyReader.onAuthenticationRequestDetected = { request in
+                Task {
+                    await model.identifyWithNFC(request)
+                }
+            }
+
+            identifyReader.onError = { message in
+                model.errorMessage = message
+            }
+        }
+        .sheet(item: $focusedRequest) { request in
+            RequestDetailSheet(request: request, model: model)
+        }
+        .sheet(isPresented: $model.isScannerPresented) {
+            QRScannerSheet(
+                seededPayload: model.session?.pairingCode ?? model.suggestedPairingPayload,
+                title: "Scan proof QR",
+                description: "Use the camera to scan an idp.global QR challenge from the site or device asking you to prove that it is really you.",
+                navigationTitle: "Scan Proof QR",
+                onCodeScanned: { payload in
+                    Task {
+                        await model.identifyWithPayload(payload, transport: .qr)
+                    }
+                }
+            )
+        }
+        .sheet(isPresented: $isOTPPresented) {
+            if let session = model.session {
+                OneTimePasscodeSheet(session: session)
+            }
+        }
+    }
+}
+
+private struct HomeTopActions: View {
+    @ObservedObject var model: AppViewModel
+    @ObservedObject var identifyReader: NFCIdentifyReader
+    let onScanQR: () -> Void
+    let onShowOTP: () -> Void
+
+    var body: some View {
+        LazyVGrid(columns: columns, spacing: 12) {
+            identifyButton
+            qrButton
+            otpButton
+        }
+    }
+
+    private var columns: [GridItem] {
+        Array(repeating: GridItem(.flexible(), spacing: 12), count: 3)
+    }
+
+    private var identifyButton: some View {
+        Button {
+            identifyReader.beginScanning()
+        } label: {
+            AppActionTile(
+                title: identifyReader.isScanning ? "Scanning NFC" : "Tap NFC",
+                systemImage: "dot.radiowaves.left.and.right",
+                tone: dashboardAccent,
+                isBusy: identifyReader.isScanning || model.isIdentifying
+            )
+        }
+        .buttonStyle(.plain)
+        .disabled(identifyReader.isScanning || !identifyReader.isSupported || model.isIdentifying)
+    }
+
+    private var qrButton: some View {
+        Button {
+            onScanQR()
+        } label: {
+            AppActionTile(
+                title: "Scan QR",
+                systemImage: "qrcode.viewfinder",
+                tone: dashboardAccent
+            )
+        }
+        .buttonStyle(.plain)
+    }
+
+    private var otpButton: some View {
+        Button {
+            onShowOTP()
+        } label: {
+            AppActionTile(
+                title: "OTP",
+                systemImage: "number.square.fill",
+                tone: dashboardGold
+            )
+        }
+        .buttonStyle(.plain)
+    }
+}
+
+private struct Sidebar: View {
+    @ObservedObject var model: AppViewModel
+
+    var body: some View {
+        List {
+            Section {
+                SidebarStatusCard(
+                    profile: model.profile,
+                    pendingCount: model.pendingRequests.count,
+                    unreadCount: model.unreadNotificationCount
+                )
+            }
+
+            Section("Workspace") {
+                ForEach(AppSection.allCases) { section in
+                    Button {
+                        model.selectedSection = section
+                    } label: {
+                        HStack {
+                            Label(section.title, systemImage: section.systemImage)
+                            Spacer()
+                            if badgeCount(for: section) > 0 {
+                                AppStatusTag(title: "\(badgeCount(for: section))", tone: dashboardAccent)
+                            }
+                        }
+                    }
+                    .buttonStyle(.plain)
+                    .listRowBackground(
+                        model.selectedSection == section
+                            ? dashboardAccent.opacity(0.10)
+                            : Color.clear
+                    )
+                }
+            }
+        }
+        .navigationTitle("idp.global")
+    }
+
+    private func badgeCount(for section: AppSection) -> Int {
+        switch section {
+        case .overview:
+            0
+        case .requests:
+            model.pendingRequests.count
+        case .activity:
+            model.unreadNotificationCount
+        case .account:
+            0
+        }
+    }
+}
+
+private struct SidebarStatusCard: View {
+    let profile: MemberProfile?
+    let pendingCount: Int
+    let unreadCount: Int
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: 10) {
+            Text("Digital Passport")
+                .font(.headline)
+
+            Text(profile?.handle ?? "No passport active")
+                .foregroundStyle(.secondary)
+
+            HStack(spacing: 8) {
+                AppStatusTag(title: "\(pendingCount) pending", tone: dashboardAccent)
+                AppStatusTag(title: "\(unreadCount) unread", tone: dashboardGold)
+            }
+        }
+        .padding(.vertical, 6)
+    }
+}

swift/Sources/Features/Home/HomeSheets.swift

@@ -0,0 +1,188 @@
+import SwiftUI
+
+struct RequestDetailSheet: View {
+    let request: ApprovalRequest
+    @ObservedObject var model: AppViewModel
+
+    @Environment(\.dismiss) private var dismiss
+
+    var body: some View {
+        NavigationStack {
+            AppScrollScreen(
+                compactLayout: true,
+                bottomPadding: AppLayout.compactBottomDockPadding
+            ) {
+                RequestDetailHero(request: request)
+
+                AppSectionCard(title: "Summary", compactLayout: true) {
+                    AppKeyValue(label: "Source", value: request.source)
+                    AppKeyValue(label: "Requested", value: request.createdAt.formatted(date: .abbreviated, time: .shortened))
+                    AppKeyValue(label: "Risk", value: request.risk.summary)
+                    AppKeyValue(label: "Type", value: request.kind.title)
+                }
+
+                AppSectionCard(title: "Proof details", compactLayout: true) {
+                    if request.scopes.isEmpty {
+                        Text("No explicit proof details were provided by the mock backend.")
+                            .foregroundStyle(.secondary)
+                    } else {
+                        Text(request.scopes.joined(separator: "\n"))
+                            .font(.body.monospaced())
+                            .foregroundStyle(.secondary)
+                    }
+                }
+
+                AppSectionCard(title: "Guidance", compactLayout: true) {
+                    Text(request.trustDetail)
+                        .foregroundStyle(.secondary)
+
+                    Text(request.risk.guidance)
+                        .font(.headline)
+                }
+
+                if request.status == .pending {
+                    AppSectionCard(title: "Actions", compactLayout: true) {
+                        VStack(spacing: 12) {
+                            Button {
+                                Task {
+                                    await model.approve(request)
+                                    dismiss()
+                                }
+                            } label: {
+                                if model.activeRequestID == request.id {
+                                    ProgressView()
+                                } else {
+                                    Label("Verify identity", systemImage: "checkmark.circle.fill")
+                                        .frame(maxWidth: .infinity)
+                                }
+                            }
+                            .buttonStyle(.borderedProminent)
+                            .disabled(model.activeRequestID == request.id)
+
+                            Button(role: .destructive) {
+                                Task {
+                                    await model.reject(request)
+                                    dismiss()
+                                }
+                            } label: {
+                                Label("Decline", systemImage: "xmark.circle.fill")
+                                    .frame(maxWidth: .infinity)
+                            }
+                            .buttonStyle(.bordered)
+                            .disabled(model.activeRequestID == request.id)
+                        }
+                    }
+                }
+            }
+            .navigationTitle("Review Proof")
+            .inlineNavigationTitleOnIOS()
+            .toolbar {
+                ToolbarItem(placement: .cancellationAction) {
+                    Button("Close") {
+                        dismiss()
+                    }
+                }
+            }
+        }
+    }
+}
+
+private struct RequestDetailHero: View {
+    let request: ApprovalRequest
+
+    private var accent: Color {
+        switch request.status {
+        case .approved:
+            .green
+        case .rejected:
+            .red
+        case .pending:
+            request.risk == .routine ? dashboardAccent : .orange
+        }
+    }
+
+    var body: some View {
+        AppPanel(compactLayout: true, radius: AppLayout.largeCardRadius) {
+            AppBadge(title: request.kind.title, tone: accent)
+
+            Text(request.title)
+                .font(.system(size: 30, weight: .bold, design: .rounded))
+                .lineLimit(3)
+
+            Text(request.subtitle)
+                .foregroundStyle(.secondary)
+
+            HStack(spacing: 8) {
+                AppStatusTag(title: request.status.title, tone: accent)
+                AppStatusTag(title: request.risk.title, tone: request.risk == .routine ? dashboardAccent : .orange)
+            }
+        }
+    }
+}
+
+struct OneTimePasscodeSheet: View {
+    let session: AuthSession
+
+    @Environment(\.dismiss) private var dismiss
+    @Environment(\.horizontalSizeClass) private var horizontalSizeClass
+
+    var body: some View {
+        NavigationStack {
+            TimelineView(.periodic(from: .now, by: 1)) { context in
+                let code = OneTimePasscodeGenerator.code(for: session.pairingCode, at: context.date)
+                let secondsRemaining = OneTimePasscodeGenerator.renewalCountdown(at: context.date)
+
+                AppScrollScreen(compactLayout: compactLayout) {
+                    AppPanel(compactLayout: compactLayout, radius: AppLayout.largeCardRadius) {
+                        AppBadge(title: "One-time passcode", tone: dashboardGold)
+
+                        Text("OTP")
+                            .font(.system(size: compactLayout ? 32 : 40, weight: .bold, design: .rounded))
+
+                        Text("Share this code only with the site or device asking you to prove that it is really you.")
+                            .font(.subheadline)
+                            .foregroundStyle(.secondary)
+
+                        Text(code)
+                            .font(.system(size: compactLayout ? 42 : 54, weight: .bold, design: .rounded).monospacedDigit())
+                            .tracking(compactLayout ? 4 : 6)
+                            .frame(maxWidth: .infinity)
+                            .padding(.vertical, compactLayout ? 16 : 20)
+                            .background(AppTheme.mutedFill, in: RoundedRectangle(cornerRadius: 24, style: .continuous))
+                            .overlay(
+                                RoundedRectangle(cornerRadius: 24, style: .continuous)
+                                    .stroke(AppTheme.border, lineWidth: 1)
+                            )
+
+                        HStack(spacing: 8) {
+                            AppStatusTag(title: "Renews in \(secondsRemaining)s", tone: dashboardGold)
+                            AppStatusTag(title: session.originHost, tone: dashboardAccent)
+                        }
+
+                        Divider()
+
+                        AppKeyValue(label: "Client", value: session.deviceName)
+                        AppKeyValue(label: "Linked", value: session.pairedAt.formatted(date: .abbreviated, time: .shortened))
+                    }
+                }
+            }
+            .navigationTitle("OTP")
+            .inlineNavigationTitleOnIOS()
+            .toolbar {
+                ToolbarItem(placement: .cancellationAction) {
+                    Button("Close") {
+                        dismiss()
+                    }
+                }
+            }
+        }
+    }
+
+    private var compactLayout: Bool {
+        #if os(iOS)
+        horizontalSizeClass == .compact
+        #else
+        false
+        #endif
+    }
+}