Deep linking

All significant feature points and views MUST be deep linkable using the platform's native URL/deep link mechanism:

  • Apple: Universal Links + custom URL schemes. onOpenURL in SwiftUI, NavigationPath for state restoration.
  • Android: App Links + intent filters. Navigation component deep link support.
  • Web: URL routing. Every view should have a unique, shareable URL.
  • Windows: Protocol activation via <uap:Protocol> declaration in manifest. AppInstance.GetActivatedEventArgs() for rich activation handling.

Each spec SHOULD include a Deep Linking section defining URL patterns.


Deep Linking

All significant feature points and views MUST be deep linkable using the platform's native URL/deep link mechanism. Each spec SHOULD include a Deep Linking section defining URL patterns.

TypeScript

Every view MUST have a unique, shareable URL. Use framework routing (React Router, Next.js routing, etc.).

Windows

Declare protocol handlers in Package.appxmanifest and handle activation through the Windows App SDK lifecycle APIs.

  • Declare: <uap:Protocol Name="myapp"/> in manifest
  • Handle via AppInstance.GetActivatedEventArgs() in App.OnLaunched
  • Parse URI to determine target page/state, navigate accordingly
  • Use AppInstance.FindOrRegisterForKey() for single-instancing (recommended for deep links)
version
1.1.0
platforms
kotlin, swift, typescript, web, windows
tags
deep-linking, platform
author
Mike Fullerton
modified
2026-04-02

Change History

Version Date Author Summary
1.0.0 2026-03-27 Mike Fullerton Initial creation
1.1.0 2026-04-02 Mike Fullerton Moved from ui/ to platform/ — system integration, not UI design