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