> For the complete documentation index, see [llms.txt](https://docs.growsurf.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.growsurf.com/getting-started-for-native-mobile.md).

# Getting Started for Native Mobile

<div align="left"><figure><img src="/files/vGVp8AZN5tbayyFVkxks" alt="" width="188"><figcaption></figcaption></figure> <figure><img src="/files/ZZTs4QzmyOgwxxQvysUo" alt="" width="188"><figcaption></figcaption></figure></div>

## Use cases <a href="#use-cases" id="use-cases"></a>

The GrowSurf mobile SDKs (iOS and Android) cover two primary use-cases:

1. Track referrals to ensure that attribution persists in referral links through app installation so that the referrer receives credit when their referral signs up.
2. Generate referral links for your logged-in users to give them a way to share their referral link and track the status of their referrals and rewards.

***

## How the mobile flow works

1. Enable Mobile SDK access for your GrowSurf program.
2. Install the native SDK.
3. Create a participant token for your logged-in app user by calling the backend [create a mobile participant token](https://docs.growsurf.com/developer-tools/rest-api/api-reference#create-mobile-participant-token), pass it to the app, then store it in the SDK. This creates a new participant or returns an existing one.
4. The user clicks a "Refer and Earn" button in the UI, which opens the GrowSurf window via `presentGrowSurfWindow()`. The user's referral link is displayed to them, along with other stats.
5. The user shares their referral link with a friend, who opens the link on their phone. The GrowSurf SDK will preserve referral attribution so that it survives during the journey where the referred friend opens or installs the app. On iOS, surviving a **cold install** (the friend installs the app from the link, then opens it) is *deferred* deep linking and depends on your attribution provider's deferred setup — see [iOS SDK Attribution Providers](/developer-tools/ios-sdk/attribution-providers.md).
6. When the referred user signs up, they will be added as a new referred participant record when you call `addReferredParticipant()`.

***

## Next steps

Look at the iOS SDK or Android SDK docs for next steps:

{% content-ref url="/pages/UD9v0rnKjJzEapAEkEY8" %}
[iOS SDK (Beta)](/developer-tools/ios-sdk.md)
{% endcontent-ref %}

{% content-ref url="/pages/upxU6CKkGvjfZGvvKtGW" %}
[Android SDK (Beta)](/developer-tools/android-sdk.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.growsurf.com/getting-started-for-native-mobile.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.