maui-deep-linking

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

Updated Nov 5, 2025
One-click install
npx skills add https://github.com/mkazimoto/AppMAUICopilot --skill maui-deep-linking
Or copy as Structured Prompt for Agent
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.