Skip to main content

AFCore Documentation

AFCore is the cross-platform Kotlin Multiplatform SDK that powers consumer health & wellness apps built on the AdvantaHealth platform. It ships native artifacts for iOS, Android, and watchOS with a single shared business-logic surface (authentication, member data, activity tracking, geofencing, push messaging, and entitlement-driven feature flags).

This site is the official documentation for SDK consumers.

Getting access​

The AFCore SDK is gated through the AIDE Developer Portal — a separate AdvantaHealth product (AdvantaHealth/AIDE) that handles account access, API keys, member rosters, delivery logs, and support tickets.

Before you integrate AFCore, your team needs:

  1. An AIDE Portal account — request access from your Advanta Health Account Manager.
  2. An API key (clientId / clientSecret) issued from AIDE — pasted into AFCoreConfig.
  3. A configured member roster — managed in AIDE (eligibility file or SSO).

AIDE has its own portal and its own docs. This site only describes what AFCore consumes from AIDE — see AIDE Developer Portal for the short summary.

What you'll find here​

SectionUse it when
InstallationSetting up the SDK on iOS or Android for the first time
Sample AppsYou want a working app to read or run end-to-end
UI ComponentsYou want themed SwiftUI / Jetpack Compose primitives to skip the design work
Core ConceptsYou're learning the SDK's lifecycle, error model, and session state
EntitlementsYou're wiring up a specific product feature (Gym Visits, SmartWalking, Mental Fitness, etc.)
RecipesYou want a copy-pasteable end-to-end flow
TroubleshootingSomething isn't behaving the way you expect
API ReferenceYou need the full Kotlin/Swift symbol surface

At a glance​

// Android
val config = AFCoreConfig.builder()
    .baseUrl("https://api.example.com")
    .clientId("YOUR_CLIENT_ID")        // from AIDE → API Keys
    .clientSecret("YOUR_CLIENT_SECRET")
    .build()
AFCore.initialize(config)
// iOS / watchOS
let config = AFCoreConfig.builder()
    .baseUrl("https://api.example.com")
    .clientId("YOUR_CLIENT_ID")        // from AIDE → API Keys
    .clientSecret("YOUR_CLIENT_SECRET")
    .build()
AFCore.shared.initialize(config: config)

Continue to Installation → Prerequisites for the full setup, or jump to a Sample App if you'd rather read working code first.

Support​

  • AIDE Developer Portal — primary entry point for keys, members, delivery logs, and support tickets
  • Email — support@advantahealth.com
  • Account Manager — Slack & escalation channel