> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cello.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Native mobile SDKs for embedding referral functionality in iOS and Android applications

<img src="https://mintcdn.com/cello/6Zr08teY9AER0ncF/sdk/mobile/sdk-mobile-referral-component-native-sdks.png?fit=max&auto=format&n=6Zr08teY9AER0ncF&q=85&s=94bddda7dbfbf347a50c12a4f0f831fd" alt="Mobile referral component interface for iOS and Android native SDKs" width="5462" height="2560" data-path="sdk/mobile/sdk-mobile-referral-component-native-sdks.png" />

## Available Mobile SDKs

Cello provides native mobile SDKs that embed a complete referral experience directly into your mobile applications, enabling users to share referral links, track rewards, and receive payouts - all without leaving your app.

<CardGroup cols={3}>
  <Card title="iOS SDK" icon="apple" href="/sdk/mobile/ios">
    Native Swift/Objective-C SDK for iOS apps
  </Card>

  <Card title="Android SDK" icon="android" href="/sdk/mobile/android">
    Native Kotlin/Java SDK for Android apps
  </Card>

  <Card title="React Native" icon="react" href="/sdk/mobile/react-native">
    Cross-platform SDK for React Native apps
  </Card>

  <Card title="Flutter" icon="flutter" href="/sdk/mobile/flutter">
    Cross-platform SDK for Flutter apps
  </Card>
</CardGroup>

## What Do Mobile SDKs Do?

The mobile SDKs provide the same comprehensive referral functionality as our web component, optimized for mobile experiences:

### Referral Component Features

* **In-app sharing interface** with native mobile sharing options (Messages, email, social media)
* **Real-time tracking** of referral performance and earned rewards
* **Reward management** with payout setup and history
* **Multi-language support** with automatic device language detection

### Native Mobile Integrations

* **Platform-specific UI** that follows iOS and Android design guidelines
* **Native sharing** using platform share sheets and messaging apps
* **Deep linking support** for seamless user journeys
* **Performance optimized** for mobile device constraints

### Customizations

You can customize the mobile Referral Component in the following ways:

* **Launcher** – Use the default button or implement a custom launcher to open the Referral component.
* **Hero Image** – Set a custom image for the sharing screen.
* **Copy** – Customize the text displayed in the component.
* **Brand Color** – Apply your brand’s primary color to match your app’s style.
* **Notification images** - Choose which image is displayed in the new view and new reward notification.
* **Dark mode** - Support for light and dark theme, with configurable colors per theme in the [Cello Portal](https://portal.cello.so) to match your app’s interface.

## Complete Mobile Referral Setup

After integrating the mobile SDK, you'll need to set up mobile attribution and referral conversion tracking:

### 1. Set Up Mobile Attribution

Configure deep linking and referral code capture for mobile app installs:

<CardGroup cols={2}>
  <Card title="Mobile Attribution Guide" icon="mobile" href="/attribution/for-mobile">
    Learn how to capture referral codes through app store installs using Branch.io or similar services
  </Card>
</CardGroup>

### 2. Track Referral Conversions

Implement signup and purchase event tracking to reward referrers:

<CardGroup cols={2}>
  <Card title="Track Signups" icon="user-plus" href="/attribution/tracking-signups">
    Send signup events when users create accounts
  </Card>

  <Card title="Track Purchases" icon="credit-card" href="/attribution/tracking-purchase">
    Send purchase events for subscription or one-time payments
  </Card>
</CardGroup>

## Getting Started

<Steps>
  <Step title="Choose Your Platform">
    Select the appropriate SDK for your mobile platform
  </Step>

  <Step title="Install & Configure">
    Follow the installation guide for your chosen SDK
  </Step>

  <Step title="Set Up Attribution">
    [Configure mobile attribution](/attribution/for-mobile) to capture referral codes from app installs
  </Step>

  <Step title="Track Referral Conversion Events">
    Implement referral events for [signups](/attribution/tracking-signups) and [purchases](/attribution/tracking-purchase) to complete the referral flow
  </Step>
</Steps>

<Note>
  Mobile SDKs work independently but can be used alongside [Cello JS](/sdk/client-side/cello-js-introduction) if you have both web and mobile versions of your product.
</Note>