capacitor-deep-linking
Complete guide to implementing deep links and universal links in Capacitor apps. Covers iOS Universal Links, Android App Links, custom URL schemes, and navigation handling. Use this skill when users need to open their app from links.
By cap-go · 1,044 installs
npx skills add cap-go/capgo-skills --skill capacitor-deep-linking
Source repository · Upstream listing
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
Type Platform Format Requires Server
Custom URL Scheme Both myapp://path No
Universal Links iOS https://myapp.com/path Yes
App Links Android https://myapp.com/path Yes
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:
1. Select App target
2. Signing & Capabilities
3. + Capability Associated Domains
4. 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
Scenario Command
Custom scheme myapp://path
Universal link cold start Tap link with app closed
Universal link warm start Tap link with app in background
Universal link in Safari Type URL in Safari
App link cold start Tap link with app closed
App link in Chrome Tap link in Chrome
Debug Tools
Common Issues
Issue Solution
Universal Links not working Check AASA file, SSL, entitlements
App Links not verified Check assetlinks.json, fingerprint
Links open in browser Check intent filter, autoVerify
Cold start not handled Use App.getLaunchUrl()
Simulator issues Reset simulator, rebuild app
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