Android SDK

repositories {
  google()
  mavenCentral()
}

dependencies {
  // Complete SDK: core APIs plus the native referral UI.
  implementation("dev.growthrail:growthrail:0.1.1")

  // Or, for a headless/custom UI integration:
  // implementation("dev.growthrail:growthrail-core:0.1.1")
}

import android.app.Application
import dev.growthrail.sdk.GrowthRail
import dev.growthrail.sdk.GrowthRailAppearance
import dev.growthrail.sdk.GrowthRailConfiguration
import dev.growthrail.sdk.GrowthRailTheme

class ExampleApplication : Application() {
  override fun onCreate() {
    super.onCreate()
    GrowthRail.initialize(
      this,
      GrowthRailConfiguration(
        projectSecretKey = "sk_your_publishable_mobile_key",
        appearance = GrowthRailAppearance.DARK,
        theme = GrowthRailTheme(primaryColor = "#2563eb"),
        debug = BuildConfig.DEBUG,
      ),
    )
  }
}

import dev.growthrail.sdk.ui.GrowthRailOverlay

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  setContentView(R.layout.activity_main)
  GrowthRailOverlay.attach(this)
}

lifecycleScope.launch {
  val user = GrowthRail.initAppUser(userId)
  val referralLink = GrowthRail.getReferralLink()
  val attributionToken = GrowthRail.getAttributionToken()
}

GrowthRail.showReferralDashboard(
  ReferrerModalOptions(
    title = "Invite Friends",
    description = "Share your link and earn rewards.",
    componentType = ReferralDashboardPresentation.DRAWER,
    appearance = GrowthRailAppearance.DARK,
    theme = GrowthRailTheme(primaryColor = "#2563eb"),
  )
)

<activity
    android:name=".MainActivity"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="your-app" />
    </intent-filter>
</activity>

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  intent.data?.let(GrowthRail::handleDeepLink)
}

override fun onNewIntent(intent: Intent) {
  super.onNewIntent(intent)
  intent.data?.let(GrowthRail::handleDeepLink)
}

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)
    GrowthRailOverlay.attach(this)
    intent.data?.let(GrowthRail::handleDeepLink)

    lifecycleScope.launch {
      GrowthRail.initAppUser("user_123")
    }

    findViewById<Button>(R.id.invite).setOnClickListener {
      GrowthRail.showReferralDashboard()
    }
  }

  override fun onNewIntent(intent: Intent) {
    super.onNewIntent(intent)
    intent.data?.let(GrowthRail::handleDeepLink)
  }
}