Capacitor Deep Linking

This walks you through the full deep linking setup for Capacitor apps, covering custom URL schemes, iOS Universal Links, and Android App Links. You get the platform-specific config files, server requirements for the apple-app-site-association and assetlinks.json files, and TypeScript handlers that actually parse URLs and route them correctly. The routing examples for React and Vue Router are directly applicable, and the testing commands for both simulators and devices save you from guessing whether your setup works. The one thing that takes time is getting the server verification right, especially Apple's CDN caching, but the verification commands help you debug that. Solid reference if you need users clicking links to land in the right place in your app.

skills.sh installs: 197
GitHub stars: 43
last updated: Jun 3, 2026

View on GitHub

Install

$ npx -y skills add cap-go/capacitor-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