Deep Link Handler
Component Detail
Description
Infrastructure component that registers the invite URL path pattern with go_router to intercept incoming deep links on app open, extracts the invite token, validates it via Referral Link Service, and routes the recipient into the appropriate onboarding or registration flow with referrer attribution pre-filled. Provides graceful App Store and Play Store fallback for recipients who do not yet have the app installed.
deep-link-handler
Sources & reasoning
Deep link routing via go_router and App Store fallback are explicitly specified in the implementation notes. Without this handler, recipients clicking invite links cannot be routed into the registration flow, breaking the end-to-end referral loop and eliminating attribution.
No source references — this artifact was included based on reasoning alone (see above).
Responsibilities
- Register invite URL scheme and path with go_router deep link configuration
- Extract and forward invite token to Referral Link Service for validation
- Route validated recipients into the onboarding flow with referrer context pre-filled
- Handle App Store / Play Store redirect fallback for non-installed app scenarios
Interfaces
handleInviteDeepLink(uri: Uri) -> GoRoute
resolveOnboardingRoute(invite: ReferralInvite) -> String
buildFallbackStoreRedirect(platform: TargetPlatform) -> Uri