Deep Linking & Universal Links

Configure deep linking and universal links in Flutter apps using go_router.

4|1|Updated Dec 17, 2025
One-click install
npx skills add https://github.com/lapc506/flutter-agentic-boilerplate --skill deep-linking-universal-links-lapc506
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Deep Linking & Universal Links
Source: https://github.com/lapc506/flutter-agentic-boilerplate/tree/main/skills/flutter/deep-linking
Command: npx skills add https://github.com/lapc506/flutter-agentic-boilerplate --skill deep-linking-universal-links-lapc506

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires go_router, uni_links, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill enables your Flutter application to respond to external links, directing users to specific content or features within the app without manual navigation.

Core Features & Use Cases

  • Universal Links (iOS) & App Links (Android): Configure your app to open directly from web URLs.
  • Custom URL Schemes: Define your own schemes (e.g., myapp://) for deep linking.
  • Dynamic Routing: Integrate with go_router to handle incoming links and navigate users to the correct screens.
  • Use Case: A user clicks a link in an email (https://yourdomain.com/product/123) and is taken directly to the product details screen within your Flutter app.

Quick Start

Implement deep linking with universal links for iOS and Android using go_router.

Frequently Asked Questions about Deep Linking & Universal Links

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement deep linking in a Flutter app using go_router?

Deep linking in a Flutter app using go_router involves configuring your router to parse incoming external URLs and navigate users to specific screens based on the path parameters and query strings. This skill provides the logic to handle both custom schemes and HTTPS links dynamically.

What is the difference between universal links and app links in Flutter?

Universal links are iOS-specific HTTP or HTTPS links that open your app directly, while app links serve the same purpose for Android. Both require configuring associated domains and app site association files to verify domain ownership and seamlessly route users into your app's content.

How do I configure Apple App Site Association files for universal links?

Configuring Apple App Site Association files involves hosting a specific JSON file on your web domain to verify your app's associated domains. This skill covers the required configuration steps to enable universal links on iOS to seamlessly navigate users into your app.

Can I use custom URL schemes with go_router for Flutter navigation?

Yes, you can use custom URL schemes like myapp:// alongside HTTPS app links with go_router. This skill facilitates handling both types of external links, enabling dynamic routing based on URL parameters and query strings to direct users to specific app content.

Why are my Flutter universal links not opening the app directly?

Universal links often fail when Android manifest entries or iOS associated domain configurations are incorrect. This skill helps you properly set up app site association files and deep link handling logic to ensure external links route dynamically into your app.

Do I need uni_links to handle deep linking in Flutter?

Yes, handling deep linking in Flutter requires the uni_links package to receive incoming external links. Combined with go_router for dynamic routing, it enables seamless navigation to specific app content from external sources like emails or web URLs.