Capacitor Deep Linking

Deep linking in Capacitor apps requires handling three different mechanisms: custom URL schemes that work offline, iOS Universal Links that need a hosted apple-app-site-association file, and Android App Links with their assetlinks.json verification. This guide walks through the platform-specific configuration (Info.plist entries, AndroidManifest intent filters, Associated Domains capabilities) and provides working code for parsing incoming URLs and routing them through React or Vue Router. The framework integration patterns are solid, and it covers the tedious verification steps like checking SHA256 fingerprints and validating those JSON files Apple and Google cache. Use this when you need users to tap a link in email or SMS and land directly on a specific screen in your app, not just on the home screen.

skills.sh installs: 1.3K
GitHub stars: 77
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add cap-go/capgo-skills --skill capacitor-deep-linking --agent claude-code

Installs into .claude/skills of the current project.

Files

Deep Linking in Capacitor

Route custom-scheme links, iOS Universal Links, and Android App Links into the web app.

When to Use

TRIGGER when:

Adding myapp:// schemes, Universal Links, or App Links to a Capacitor app
Links open the browser instead of the app, or open the app but land on the home page
appUrlOpen fires on warm open but the URL is missing on cold launch (or the reverse)
Deep links broke after updating to Capacitor 8.5+ / adopting SceneDelegate.swift
OAuth / magic-link / payment redirects must come back into the app
adb shell pm get-app-links shows none or 1024 instead of verified

Do not use:

Full AppDelegate -> SceneDelegate migration of an app: capacitor-uiscene-migration
Notification tap routing: capacitor-push-notifications
Native log capture while debugging: ios-android-logs
Sign in with Apple / Google plugin config: capacitor-plugins