Skip to main content

Sample Apps

The AFCore repository ships two reference apps that exercise the public SDK surface end to end. They are the quickest way to see how the pieces fit together, and a working reference to copy from while you integrate.

PlatformLocationUI
Androidsample/androidJetpack Compose
iOSsample/iosSwiftUI

What the samples show​

  • Start without keys: the apps initialize themselves on QA, members sign in with username and password, and client credentials are asked for only by External ID sign-in.
  • Five tabs -- Home, Activity, Check-In, Explore and Profile -- built with AFCoreUI.
  • Every major feature: sign-in and session handling, profile and programs, the activity calendar, favorites and visit detection, SmartWalking, Self-Report, barcode check-in, Fit@Home, Mental Fitness, ActivePerks and server-driven content.
  • The same screens and behavior on both platforms, so Android and iOS teams can read each other's code.

Run a sample​

Build from source:

Prebuilt sample builds are not distributed publicly.

Local mode (no QA backend needed)​

Debug builds of both samples can run against the mock backend in tools/local-backend, which serves one deterministic test member. Its README explains how to start it and launch each sample against it.

Push notifications​

Both samples receive push notifications. Profile → Notifications shows this install's push token with a Copy token button and whether it is registered with AFCore, so you can send a test message from the Firebase console. To use your own Firebase project, register the sample's bundle / application id in it and replace the sample's Firebase config files. See Push Notifications.

What's not in the samples​

  • No client secrets -- never commit one to your fork.
  • No production member data -- use a QA API key and a test member.
  • No release signing.

Learn more​

See the API Reference. Complete integration guides are in AIDE Docs.