maui-deep-linking

Configure Android App Links and iOS Universal Links for .NET MAUI deep linking.

Updated Nov 5, 2025

Search Tags:#routing #ios #android #deep-linking #universal-links #maui #shell-navigation

Ready to run

npx skills add https://github.com/mkazimoto/AppMAUICopilot --skill maui-deep-linking

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: maui-deep-linking
Source: https://github.com/mkazimoto/AppMAUICopilot/tree/main/.github/skills/maui-deep-linking
Command: npx skills add https://github.com/mkazimoto/AppMAUICopilot --skill maui-deep-linking

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deep linking enables apps to be opened directly to content via URLs across Android and iOS, improving user acquisition and navigation efficiency.

Core Features & Use Cases

Android App Links with AutoVerify and domain verification
iOS Universal Links with Associated Domains and AASA handling
Custom URI schemes and Shell route mapping for cross-platform routing
Testing and debugging of incoming URLs and navigation flows

Quick Start

Configure your MAUI project to handle incoming URLs by registering routes and enabling platform-specific deep-link handling.

Frequently Asked Questions about maui-deep-linking

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

FAQPage Schema

How do I set up deep linking in a .NET MAUI app for both Android and iOS?▼

Deep linking in .NET MAUI requires configuring Android App Links with auto-verification and iOS Universal Links with Associated Domains. You map incoming URLs to in-app pages by registering Shell routes and wiring platform-specific intent filters.

What is the difference between universal links and custom URI schemes in MAUI?▼

Universal links and Android App Links use verified HTTP URLs to securely route users directly to content, bypassing the app chooser. Custom URI schemes provide simpler cross-platform routing but lack domain ownership verification. Both require Shell route mapping to navigate in-app pages.

Do I need domain verification assets to enable Android App Links in MAUI?▼

Yes, enabling Android App Links requires hosting domain verification assets so the OS can verify your ownership. You must publish a valid asset file to your web domain and configure intent filters with auto-verify in your MAUI Android manifest.

How do I map incoming deep link URLs to Shell navigation routes in MAUI?▼

Mapping URLs to Shell navigation routes involves registering specific page paths in your MAUI routing logic and handling the incoming URI payload. This wires the cross-platform routing system so external links open the correct in-app content.

Why are my iOS Universal Links not opening the MAUI app directly?▼

iOS Universal Links fail when Associated Domains are misconfigured or the AASA file is unreachable from your domain. You must ensure the entitlement is correct and the apple-app-site-association asset is served over HTTPS without redirection.

Can I test and debug incoming deep link URLs in MAUI without publishing?▼

Yes, you can test and debug incoming URLs and navigation flows locally by triggering custom URI schemes and universal links via platform-specific tools. This verifies your Shell route mapping and intent filters before deploying to production.