Fully Apple-native,
zero dependencies.

Weather is fetched through WeatherKit.WeatherService, wrapped in a Swift actor to serialise concurrent requests and avoid redundant network calls. The raw Celsius value is converted via a custom Humanus algorithm — a piecewise linear interpolation over 122 empirically mapped temperature points — before display or storage.

RoamerLocation.LocationManager handles authorisation state, one-shot location requests, and timeout recovery. Reverse geocoding (coordinate → placename) is a single async static method used by both the app and the widget extension. No third-party geocoding or maps SDKs.

The location picker uses MKLocalSearchCompleter — MapKit's native type-ahead engine — to provide live city search results biased to the user's current region. Results are resolved to coordinates via MKLocalSearch without leaving Apple's infrastructure.

RoamerStoreKit.StoreKitController monitors Transaction.updates in a background task. EntitlementsManager<T> is generic over the app's own ProductTier enum. Purchased tier IDs are JSON-encoded into a shared App Group UserDefaults key so the widget reads entitlements without an IPC round-trip.

RoamerCloudKit.CloudKitFetcher<T> is a generic record fetcher backed by a CacheManager that serves stale data synchronously while refreshing asynchronously. It powers the in-app CMS: promotional cards and targeting rules are authored in CloudKit Dashboard and fetched at runtime — no app update required for content changes.

The widget is an AppIntentTimelineProvider configured by a custom intent. Premium users choose a location via an EntityQuery backed by WidgetLocationStore — a shared App Group store with a 20-entry recents list and an append-only UUID registry for stable entity resolution. Reverse geocoding runs in the timeline provider and writes results back so subsequent renders never re-geocode.

All cross-process data — entitlements, device location cache, widget recents, location registry, feature flags — travels through a single shared UserDefaults App Group suite. JSON encoding is used consistently throughout.

Deep links (humanus://location-picker, humanus://home) and universal links are handled in HumanusApp and dispatched to AppState flags drained by ContentView once the scene is active. This drives App Store in-app events and widget onboarding flows.

Build, test, and TestFlight distribution run entirely on Xcode Cloud. A single post-clone script clones RoamerFoundation so local package paths resolve in CI identically to local dev. No third-party CI service, no Fastlane, no GitHub Actions.