maui-deep-linking

Configure verified Android App Links and iOS Universal Links in .NET MAUI apps.

Updated Nov 27, 2025
One-click install
npx skills add https://github.com/seydakaratekeli/KamPay3 --skill maui-deep-linking-seydakaratekeli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maui-deep-linking
Source: https://github.com/seydakaratekeli/KamPay3/tree/main/KamPay/.github/skills/maui-deep-linking%20-%20Kopyala
Command: npx skills add https://github.com/seydakaratekeli/KamPay3 --skill maui-deep-linking-seydakaratekeli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Deep links from web pages or other apps often fail to open the correct page in a .NET MAUI app or fall back to a browser when verification and lifecycle handling are not configured correctly. This guide helps developers implement verified Android App Links and iOS Universal Links, configure domain verification, and ensure deep link handlers run reliably across cold starts and warm launches.

Core Features & Use Cases

  • Android App Links & AutoVerify: Configure intent filters with AutoVerify and host assetlinks.json with the correct SHA-256 fingerprint to allow verified https links to open the app without prompts.
  • iOS Universal Links & AASA: Add applinks: entries to Associated Domains, host the Apple App Site Association file, and handle the three lifecycle entry points to receive links on physical devices.
  • Robust Handling & Shell Integration: Ensure intents and activities are processed in both cold and warm starts, dispatch navigation to the main thread, register Shell routes before use, and choose custom schemes only for app-to-app scenarios.

Quick Start

Help me implement verified Android App Links and iOS Universal Links in a .NET MAUI app, including intent filters with AutoVerify, assetlinks.json and AASA files, associated domain entitlements, and lifecycle handlers for OnCreate/OnNewIntent and iOS launch/continue/scene events.

Frequently Asked Questions about maui-deep-linking

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

FAQPage Schema
How do I configure Android App Links with AutoVerify in .NET MAUI?

Configuring Android App Links in .NET MAUI requires intent filters with AutoVerify and a hosted assetlinks.json file containing the correct SHA-256 fingerprint. This allows verified https links to open the app directly without user prompts.

What is needed for iOS Universal Links to work in a .NET MAUI app?

iOS Universal Links in .NET MAUI require adding applinks: entries to Associated Domains, hosting an Apple App Site Association (AASA) file, and handling FinishedLaunching, ContinueUserActivity, and SceneWillConnect lifecycle events on physical devices.

Why do deep links fail to open my .NET MAUI app on cold start versus warm start?

Deep links fail across cold and warm starts when lifecycle handlers are not configured correctly. You must handle OnCreate and OnNewIntent on Android, and dispatch Shell navigation on the main thread to ensure reliable routing.

When should I use custom URI schemes instead of verified web links in MAUI?

Use custom URI schemes only for app-to-app scenarios as a fallback. Verified Android App Links and iOS Universal Links are preferred for opening app routes from web URLs to avoid falling back to a browser.

Does deep linking in .NET MAUI require registering Shell routes before navigation?

Yes, deep linking in .NET MAUI requires registering Shell routes before use and dispatching navigation to the main thread. This ensures intents and activities are processed correctly across both cold and warm launches.