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

# Quickstart

> Integrate the DeepLink Flutter SDK and Track Install in under 5 minutes

This guide gets you from zero to tracking app installs with DeepLink.

## 1. Install the package

Add the `deeplink_flutter_sdk` package to your Flutter project:

```bash theme={null}
flutter pub add deeplink_flutter_sdk
```

## 2. Configure Android

In your Android app, add the **Install Referrer** dependency and configure your deep link domain so clicks can be attributed.

<Card title="Android setup" icon="android" href="/sdk/android-setup">
  App links, referrer, and ProGuard rules.
</Card>

## 3. Configure iOS

Set up Associated Domains and entitlements so iOS can open your app from DeepLink links.

<Card title="iOS setup" icon="apple-whole" href="/sdk/ios-setup">
  Associated Domains and URL handling.
</Card>

## 4. Initialize the SDK and track installs

In your app’s entry point (e.g. after the app is ready), call the DeepLink SDK so it can record the install and fetch attribution (e.g. UTM from the last click).

```dart theme={null}
import 'package:deeplink_flutter_sdk/deeplink_sdk.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // One-time install attribution (first run only)
  await Deeplink().init(
    apiKey: 'your_api_key', // Get this from the DeepLink dashboard
  );

  runApp(const MyApp());
}
```

The SDK will:

* On **Android**: use the Play Install Referrer (when available) or an explicit `linkId` to attribute the install and report it to the Track Install API.
* On **iOS**: score recent clicks (IP, country, city, platform, OS version, deviceId when present) to find the best matching click and send its UTM and link data to the Track Install API.

## 5. Handle incoming deep links

To open a specific screen when the user opens a DeepLink URL (including after install), use the SDK’s link handling:

<Card title="Handling links" icon="link" href="/sdk/handling-links">
  Listen for deep link URLs and navigate in-app.
</Card>

## Next steps

* Create links in the [Dashboard](https://deeplink.in) and test with your app.
* Use the [Track Install API](/api-reference/track-install) directly if you are not using the Flutter SDK.
