deep-linking

Deep Linking Generator

Generate deep linking infrastructure with URL schemes, Universal Links, and App Intents for Siri/Shortcuts.

When This Skill Activates

• User wants to handle custom URL schemes (myapp://)
• User mentions Universal Links or Associated Domains
• User wants Siri Shortcuts or App Intents
• User needs to navigate to specific content from external sources

Pre-Generation Checks

Before generating, verify:

1. Existing Deep Link Handling

   # Check for existing URL handling
   grep -r "onOpenURL\|open.*url\|handleOpen" --include="*.swift" | head -5
   

2. URL Scheme in Info.plist

   # Check for CFBundleURLTypes
   find . -name "Info.plist" -exec grep -l "CFBundleURLSchemes" {} \;
   

3. Associated Domains Entitlement

   find . -name "*.entitlements" -exec grep -l "associated-domains" {} \;
   

Configuration Questions

1. URL Scheme

• What custom URL scheme? (e.g., myapp)
• This enables myapp://path/to/content links

2. Universal Links

• Yes - Handle HTTPS links (requires AASA file on server)
• No - Custom URL scheme only

3. App Intents / Siri Shortcuts

• Yes - Enable voice commands and Shortcuts app
• No - URL-based deep linking only

4. Link Types

• Profile: /users/{id}
• Content: /items/{id}
• Actions: /actions/share, /actions/create
• Custom routes based on app needs

Generated Files

Core Infrastructure

Sources/DeepLinking/
├── DeepLinkRouter.swift       # Central router
├── DeepLink.swift             # Route definitions
└── UniversalLinkHandler.swift # Universal link processing

App Intents (Optional)

Sources/AppIntents/
├── OpenContentIntent.swift    # Open specific content
├── AppShortcuts.swift         # Shortcuts provider
└── ContentEntity.swift        # Entities for Spotlight/Siri

Server Files (Universal Links)

.well-known/
└── apple-app-site-association  # AASA file template

Key Features