# Zing Fitness AI Coach — B2B Partner Documentation

> Zing is an AI-powered fitness coaching platform that B2B partners integrate into their own products. Partners can choose from three integration models: a **Branded Experience** (deep-link to a Zing app with partner branding), a **Mobile SDK** (native iOS and Android, plus cross-platform adapters for Flutter, React Native, and other frameworks, embedded in the partner’s own app), or a **White-Label** solution (fully branded, sales-led engagement). A server-to-server **Partner API** (REST + Webhooks) is available alongside any model for data sync and reporting.

**How the models relate**

- **Branded Experience** requires no mobile app development: it is a deep-link, partner configuration, and managed-app model.
- The **Mobile SDK** is the primary in-app path for partners with their own mobile codebase; it supports three UI tiers: Full Screen UI, UI Components, and Headless API.
- **White-Label** is typically a sales-led engagement; technical and operational details are coordinated directly with Zing.
- The **Partner API** is separate from the client (mobile) integration; it can be used alongside any of the models above.

## Integration Paths

- [Integration paths overview](https://developer.zing.coach/integration/): When to use Branded, SDK, or White-Label
- [Branded Experience](https://developer.zing.coach/integration/branded/): Deep links, URL parameters, partner config — no SDK code
- [SDK in your app](https://developer.zing.coach/integration/sdk/): Embedding the mobile SDK
- [White-Label](https://developer.zing.coach/integration/whitelabel/): Fully managed branded app (overview)

## SDK documentation structure

High-level map of the SDK section on the site:

- [SDK overview (hub)](https://developer.zing.coach/sdk/): Links into Getting Started, Features, and Platforms.
- [Platform support index](https://developer.zing.coach/sdk/platforms/): Landing page that splits **native** guides (iOS, Android) from the **Cross-Platform** subsection below.

### Native SDKs (authoritative implementation guides)

Use these when you integrate directly in Kotlin/Swift.

- [Android (Kotlin, Gradle, Health Connect)](https://developer.zing.coach/sdk/platforms/android/): GitHub Packages Maven, Hilt, `ZingSdk` init, API key or external token auth, login/logout, launching the SDK experience
- [iOS (Swift, SPM)](https://developer.zing.coach/sdk/platforms/ios/): Package setup, `ZingSDK` initialization, `AuthProvider`, token/JWT flow, `login` / `logout`, view-controller factories, error types

### Cross-Platform (nested under Platforms)

The native SDKs are wrapped by adapters. Same concepts as native; bridge code delegates to iOS/Android.

- [Cross-Platform overview](https://developer.zing.coach/sdk/platforms/cross-platform/): When to use an adapter; Flutter and React Native references; other frameworks (KMP, Capacitor, etc.) can bridge the same native surface.
- [Flutter (Dart + native Android/iOS config)](https://developer.zing.coach/sdk/platforms/cross-platform/flutter/): Git `pub` dependency, Maven/Hilt and host activity on Android, initialization, auth, screen routing, errors — mirrors native SDK behavior.
- [React Native (Expo sample)](https://developer.zing.coach/sdk/platforms/cross-platform/react-native/): Public sample repo, Expo prebuild, Maven credentials for Android artifacts, JS/native module bridge.

The former standalone URL `/sdk/platforms/flutter/` is retired; Flutter documentation lives under **`/sdk/platforms/cross-platform/flutter/`**.

## SDK — Getting Started (supporting)

Read alongside the platform guide for constraints, permissions, and architecture choices.

- [System requirements](https://developer.zing.coach/sdk/getting-started/system-requirements/): Minimum Android, iOS, and cross-platform toolchains (Flutter, React Native, plus notes for other bridges)
- [SDK layers (Full UI vs components vs headless)](https://developer.zing.coach/sdk/getting-started/sdk-layers/): How to pick and mix integration modes
- [Installation and permissions](https://developer.zing.coach/sdk/getting-started/installation-and-permissions/): Install tabs for iOS, Android, Flutter, React Native; optional permissions (manifest, plist)
- [Authorization (conceptual)](https://developer.zing.coach/sdk/getting-started/authorization/): IdP → Zing-issued access → SDK session; pair with the platform page for concrete APIs
- [Initialisation (checklist)](https://developer.zing.coach/sdk/getting-started/initialisation/): Conceptual startup checklist; native and cross-platform guides hold the real init code
- [Configuration (checklist)](https://developer.zing.coach/sdk/getting-started/configuration/): Tenant/environment and feature configuration concepts

## Server-to-Server API

For backend integration on **any** partner model (complements the mobile path; not a replacement for the SDK in-app work).

- [API overview](https://developer.zing.coach/api/): Pull API vs webhooks, when to use each
- [Pull API](https://developer.zing.coach/api/pull/): REST data access, authentication, pagination, and filters
- [Webhooks](https://developer.zing.coach/api/webhooks/): Event delivery, signatures, `event_id` idempotency, verification
- [Interactive API reference (OpenAPI UI)](https://developer.zing.coach/api/reference/): Explorable OpenAPI 3.1 (Pull + webhook contracts)
- [OpenAPI 3.1 spec (raw YAML)](https://developer.zing.coach/openapi/s2s_api.yaml): Machine-readable definition for code generation and tooling

## Optional

Context and navigation you can often skip for a first implementation; subsections are mostly product guidance, not a substitute for the platform guides.

- [Introduction](https://developer.zing.coach/): High-level product and feature overview
- [SDK features overview](https://developer.zing.coach/sdk/sdk-features/): Full UI, UI components, headless at a glance
- [Full screen UI (guidance)](https://developer.zing.coach/sdk/sdk-features/full-screen-ui/)
- [UI components (guidance)](https://developer.zing.coach/sdk/sdk-features/ui-components/)
- [Headless API (guidance)](https://developer.zing.coach/sdk/sdk-features/headless-api/)
- [Admin UI](https://developer.zing.coach/admin-ui/): Partner operations portal (placeholders may apply)
- [Changelog](https://developer.zing.coach/changelog/): Release notes
- [Contact and support](https://developer.zing.coach/contact-support/): Program links and escalation