sample-ios

ForgeNav iOS sample

Compose Multiplatform sample hosting the same offline-first tasks UI as Android/Desktop.

Aligned with library v1.1.0 (Nav3 Phase A navigation APIs available; sample uses saveable host + stack deep links).

Layout

Path	Role
sample-ios/	KMP module producing the ForgeNavSample framework
iosApp/	Xcode/SwiftUI shell embedding Compose

Requirements

• macOS + Xcode 15+ (iOS 14.1+)
• JDK 17
• This repo’s Gradle wrapper

Linux CI only configures iOS targets (kotlin.native.ignoreDisabledTargets=true); it does not compile native binaries.

Run on simulator / device

# From repo root (optional prebuild)
./gradlew :sample-ios:linkDebugFrameworkIosSimulatorArm64

# Open Xcode
open iosApp/iosApp.xcodeproj

In Xcode:

1. Select the iosApp scheme and an iOS Simulator (e.g. iPhone 16).
2. Set your Team in Signing if needed (iosApp/Configuration/Config.xcconfig → TEAM_ID).
3. Run (⌘R).

The Xcode Compile Kotlin Framework phase runs:

./gradlew :sample-ios:embedAndSignAppleFrameworkForXcode

What the sample demonstrates

• Type-safe navigation (ForgeNavHost + transitions)
• Saveable navigator (rememberSaveableForgeNavigator + RouteCodec)
• Deep link stack rebuild (forgenav://tasks/{id} → Home → Detail)
• Real SyncForge loop via LocalSyncForgeLoop (outbox, offline, conflicts)
• Sync status UI (badges, offline banner, conflict dialog)

Deep links

Android registers forgenav://tasks/{id} and rebuilds the stack via DeepLinkPattern.stackPrefix.
iOS: add URL types to Info.plist if needed; pass the URI into SampleApp(deepLinkUri = …) from Swift onOpenURL.

Troubleshooting

Issue	Fix
Framework not found	Clean build folder in Xcode; re-run Gradle embed task
Signing errors	Set TEAM_ID in Config.xcconfig
Gradle fails on SyncForge	CI uses Maven Central studio.syncforge:syncforge:2.0.0; local optional composite needs ../syncforge
Blank UI	Confirm scheme uses Debug and simulator matches arm64/x64 framework