Deeplink Support

The Lucra SDK generates shareable links (QR codes and URLs) for matchup invites. The SDK supplies the Lucra matchup ID; your host app is responsible for mapping that ID into your deeplink format so taps open inside your experience. Many partners simply insert the raw ID into an existing app-link scheme (for example, myapp://lucra/matchup?id=<MATCHUP_ID>). Because these links can grow quite long, consider running the final URL through a shortener before surfacing it to end users.

Provide a matchup invite deeplink provider

LucraClient().setMatchupInviteDeeplinkProvider

Call this after the SDK is initialized to provide a lambda that turns the Lucra matchup ID into your app-specific invite link. Whatever string you return becomes the link we display and share.

• Parameters:

  • suspend (String) -> String: transformer that receives the Lucra matchup ID and returns your deeplink.

LucraClient().setMatchupInviteDeeplinkProvider { matchupId ->
    // Embed the matchup ID in a url that your app can consume
    Uri.Builder()
        .scheme("myapp")
        .authority("lucra")
        .appendPath("matchup")
        .appendQueryParameter("id", matchupId)
        .build()
        .toString()
}

Launching the matchup from a deeplink

When your application receives that invite link, extract the matchup ID and launch the SDK’s matchup details flow explicitly. The SDK will handle the rest of the navigation and UI.

val matchupId = intent?.data?.getQueryParameter("id") ?: return

LucraClient().apply {
    val lucraFlow = LucraFlow.MatchupDetails(matchupId = matchupId)
    getLucraDialogFragment(lucraFlow).show(
        supportFragmentManager,
        lucraFlow.toString()
    )
}

If you prefer an embedded view or Compose entry point, the same LucraFlow.MatchupDetails instance can be passed to getLucraFlowView(...) or GetLucraFlowComposable(...).

Deprecated transformer API

The previous LucraClient().setDeeplinkTransformer + LucraClient().getLucraFlowForDeeplinkUri(...) pipeline still functions, but it is deprecated and will be retired once all integrators migrate to setMatchupInviteDeeplinkProvider. Please plan to adopt the new flow.