Deep Linking & Navigation Design

You are a mobile navigation architect who has designed deep linking systems handling millions of link resolutions daily across iOS and Android applications. Create a complete deep linking and navigation architecture for the following application.

App Details:
App Name: [APP NAME]
App Category: [E-COMMERCE/SOCIAL/CONTENT/FINTECH/SAAS]
Platforms: [iOS/ANDROID/BOTH]
Web Presence: [FULL WEBSITE/LANDING PAGES/NO WEB]
Marketing Channels: [EMAIL/SMS/SOCIAL/ADS/QR CODES]
Authentication Required: [FOR ALL CONTENT/SOME CONTENT/PUBLIC CONTENT]
Current Deep Link Support: [NONE/BASIC/ADVANCED]

Section 1 - URL Scheme and Link Architecture:
Design the URL structure that serves both the website and app deep links using a unified pattern that works for universal links on iOS and app links on Android. Define the path hierarchy mapping app screens to URL paths with a clear and consistent naming convention that supports future screen additions. Specify the query parameter schema for passing contextual data through links including product identifiers, referral codes, campaign tracking parameters, and state information. Create the custom URL scheme as a fallback for scenarios where universal links or app links cannot be used, with clear documentation of when each scheme is appropriate. Address the link shortening and tracking strategy integrating with services like Branch, Adjust, or Firebase Dynamic Links for attribution and analytics while maintaining a clean user-facing URL structure.

Section 2 - Universal Links and App Links Configuration:
Define the Apple Associated Domains configuration including the apple-app-site-association file structure with the specific paths and patterns that should open in the app versus the browser. Specify the Android App Links configuration including the assetlinks.json file, intent filter declarations, and the autoVerify setting for instant link verification. Create the web fallback strategy for users who do not have the app installed, directing them to the appropriate web page or the app store listing with context preservation. Design the content type routing logic that determines which links open in the app, which open in the browser, and which present the user with a choice. Address the debugging and validation process for confirming that link association files are correctly hosted, cached, and recognized by both platforms.

Section 3 - Deferred Deep Linking and Attribution:
Design the deferred deep linking flow that preserves the intended destination through the app store installation process so new users land on the correct screen after their first app launch. Specify the attribution data that should be captured from deep links including campaign source, medium, content variant, and referrer identity for marketing analytics. Create the fingerprinting and clipboard-based matching fallback strategy for scenarios where deterministic attribution through platform APIs is not available. Define the onboarding integration for deferred deep links ensuring that new users complete necessary setup steps before being redirected to the deep link destination. Address the privacy-compliant attribution approach that works within Apple App Tracking Transparency restrictions and provides meaningful attribution data without relying on device identifiers.

Section 4 - Navigation State Management:
Design the navigation state machine that handles deep link arrival at any point in the app lifecycle including cold start, warm start, and while the app is in the foreground. Specify the navigation stack construction logic that builds the correct back stack when a deep link lands the user on a nested screen so the back button navigates through the expected parent screens. Create the authentication gate strategy for deep links targeting authenticated content, including queuing the deep link destination, presenting the login flow, and then navigating to the intended screen after successful authentication. Define the conflict resolution rules for when a deep link arrives while the user is in the middle of an active task such as filling out a form or viewing a transaction. Address the navigation state persistence strategy that saves and restores the current navigation stack across app restarts, process death, and configuration changes.

Section 5 - Link Generation and Sharing:
Design the share link generation system that creates deep links from within the app for user-generated sharing including social media posts, messaging apps, email, and copy-to-clipboard. Specify the Open Graph and Twitter Card metadata strategy for shared links ensuring rich previews appear in social media feeds and messaging apps. Create the dynamic link generation for marketing campaigns, push notifications, and email communications with server-side link creation APIs. Define the QR code deep linking strategy for offline-to-online experiences including physical marketing materials, in-store displays, and event materials. Address the link preview customization allowing different preview images and descriptions based on the shared content while maintaining a consistent brand appearance.

Section 6 - Testing, Monitoring, and Maintenance:
Define the deep link testing strategy covering every link pattern across both platforms including fresh install, existing install, logged-in, logged-out, and various app states. Specify the automated deep link testing using UI testing frameworks that verify link resolution, screen navigation, and context passing for all supported link patterns. Create the link monitoring dashboard tracking link resolution success rates, fallback rates, deferred deep link match rates, and average resolution time. Design the broken link detection and alerting system that identifies when links start failing due to app updates, server changes, or configuration issues. Address the deep link versioning strategy for handling links that reference screens or content structures that have changed between app versions, ensuring old links continue to resolve gracefully.