Troubleshooting

Common issues when setting up Universal Links, App Links, and match().

Universal Links not working on iOS

• Check Associated Domains is added in Xcode.
• Check apple-app-site-association is accessible: https://yourapp.flku.dev/.well-known/apple-app-site-association
• Must open the link from another app (Messages, Safari)—not by typing it in the browser address bar.
• Re-install the app after adding Associated Domains.

App Links not working on Android

• Check the intent filter is in AndroidManifest.xml with android:autoVerify="true".
• Check assetlinks.json is accessible: https://yourapp.flku.dev/.well-known/assetlinks.json
• Verify the SHA-256 fingerprint matches your release keystore.
• Run: adb shell pm get-app-links your.package.name

match() always returns matched: false

• Make sure you open the link in Safari or Chrome (do not type the URL manually in the address bar).
• The fingerprint expires after 10 minutes—tap the link and open the app within 10 minutes.
• Call Flinku.reset() and try again.
• Check the subdomain in your baseUrl matches your project subdomain exactly.

match() called twice

• Flinku prevents double matching automatically after the first successful match.
• Call Flinku.reset() during development to clear stored match state.

Bundle ID mismatch error when creating project

• The Bundle ID must exactly match what is in your App Store listing.
• Find it in Xcode → Target → General → Bundle Identifier.
• It must match the app at the App Store URL you provided in the project.