Deep Linking in Capacitor
Implement deep links, universal links, and app links in Capacitor apps.
When to Use This Skill
- User wants deep links
- User needs universal links
- User asks about URL schemes
- User wants to open app from links
- User needs share links
Types of Deep Links
Quick Start
Install Plugin
Handle Deep Links
Custom URL Scheme
iOS Configuration
Android Configuration
Test Custom Scheme
Universal Links (iOS)
1. Enable Associated Domains
In Xcode:
- Select App target
- Signing & Capabilities
-
- Capability > Associated Domains
- Add:
applinks:myapp.com
2. Create apple-app-site-association
Host at https://myapp.com/.well-known/apple-app-site-association:
Requirements:
- Served over HTTPS
- Content-Type:
application/json - No redirects
- File at root domain
3. Info.plist
Verify Universal Links
App Links (Android)
1. Create assetlinks.json
Host at https://myapp.com/.well-known/assetlinks.json:
Get SHA256 Fingerprint
2. AndroidManifest.xml
Verify App Links
Advanced Routing
React Router Integration
Vue Router Integration
Deferred Deep Links
Handle links when app wasn't installed:
Query Parameters
OAuth Callback Handling
Testing
Test Matrix
Debug Tools
Common Issues
Resources
- Capacitor App Plugin: https://capacitorjs.com/docs/apis/app
- Universal Links Guide: https://developer.apple.com/documentation/xcode/supporting-universal-links-in-your-app
- Android App Links: https://developer.android.com/training/app-links
- Digital Asset Links Validator: https://developers.google.com/digital-asset-links/tools/generator


