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

# Installation Guide (SDK v3)

> Step-by-step instructions to integrate Gameball SDK v3 with your application across supported platforms.

<Info>
  This guide is for **SDK v3** which features modern builder patterns, improved type safety, and enhanced performance. If you're looking for SDK v2 documentation, switch versions using the dropdown above.
</Info>

<CardGroup cols={2}>
  <Card title="Web" icon="globe" href="/installation-guides/v3/web">
    Integrate Gameball with your website or web application using JavaScript SDK
  </Card>

  <Card title="Android" icon="android" href="/installation-guides/v3/android">
    Integrate Gameball with your Android application using SDK v3.1.1 with modern Kotlin patterns
  </Card>

  <Card title="Flutter" icon="flutter" href="/installation-guides/v3/flutter">
    Integrate Gameball with your Flutter application using SDK v3.1.1 with builder patterns
  </Card>

  <Card title="React Native" icon="react" href="/installation-guides/v3/react-native">
    Integrate Gameball with your React Native application using SDK v3.1.2 with TypeScript support
  </Card>

  <Card title="iOS" icon="apple" href="/installation-guides/v3/ios">
    Integrate Gameball with your iOS application using SDK v3.1.1 with Swift support
  </Card>
</CardGroup>

## What's New in SDK v3

<CardGroup cols={2}>
  <Card title="Builder Pattern API" icon="code">
    Modern builder patterns for type-safe configuration and requests
  </Card>

  <Card title="Better Performance" icon="gauge-high">
    Optimized SDK initialization and reduced memory footprint
  </Card>

  <Card title="Enhanced Type Safety" icon="shield">
    Stronger compile-time validation and null safety support
  </Card>

  <Card title="Improved Error Handling" icon="triangle-exclamation">
    Better error messages and callback-based async operations
  </Card>
</CardGroup>

## What you'll learn

Each platform guide covers the essential integration steps:

* **Getting Started** - Install SDK and set up dependencies
* **Initialize SDK** - Configure SDK with builder pattern
* **Initialize Customer Profile** - Register customers and show profile widget
* **Track Customer Events** - Send customer actions and behaviors to Gameball
* **Track Orders & Cashback** - Monitor orders and provide cashback rewards
* **Integrate Redemption** - Enable customers to redeem their earned points
* **Track Referrals** - Implement referral tracking with Firebase Dynamic Links
* **Go-Live Checklist** - Ensure everything is ready for production
* **Migration Notes** - Migrate from v2 to v3

## Prerequisites

Before starting your integration, make sure you have:

* A Gameball account with API credentials
* Your application's development environment set up
* Basic understanding of your chosen platform's development workflow

<Tip>
  SDK v3 is available for **Web**, **Android**, **Flutter**, **React Native**, and **iOS**.
</Tip>

## Migration from v2

If you're currently using SDK v2 and want to upgrade:

* [Android v2 to v3 Migration Guide](/installation-guides/v3/android/migration-notes)
* [Flutter v2 to v3 Migration Guide](/installation-guides/v3/flutter/migration-notes)
* [React Native v2 to v3 Migration Guide](/installation-guides/v3/react-native/migration-notes)