configuring-deep-links

Flutter Deep Linking (with GoRouter v17.x)

Goal

Implement secure, professional Deep Links (HTTPS Domain Association) to successfully route organic URLs, marketing campaigns (Google Ads), and Magic Link auth payloads directly into a Flutter application. Avoid older Custom URL Schemes (myapp://) whenever possible, guaranteeing a seamless fallback to web browsers if the app is currently uninstalled.

Instructions

1. Android App Links Setup

AndroidManifest.xml

Insert the intent-filter explicitly instructing Android to autoVerify the HTTPS domain. This lives directly inside the core <activity> tag (usually .MainActivity):

<intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <!-- Replace with the actual requested domain -->
    <data android:scheme="https" android:host="yourdomain.com" />
</intent-filter>

Web Hosting (assetlinks.json)

You must host a JSON payload securely proving ownership at exactly: https://yourdomain.com/.well-known/assetlinks.json

[{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.yourcompany.yourapp",
    "sha256_cert_fingerprints": [
      "YOUR_SHA256_CERT_FINGERPRINT_1"
    ]
  }
}]

Constraints:

• The file must be served strictly over HTTPS.
• Must return a Content-Type: application/json header natively.

2. iOS Universal Links Setup

Xcode Entitlements

1. Open ios/Runner.xcworkspace utilizing Xcode.
2. Select the Runner Target -> "Signing & Capabilities".
3. Add the Associated Domains capability.
4. Add the exact required string entry: applinks:yourdomain.com

Web Hosting (apple-app-site-association)

You must host an AASA (Apple App Site Association) file proving ownership at exactly: https://yourdomain.com/.well-known/apple-app-site-association