Deep Linking Documentation

{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "<TEAMID>.<BUNDLEID>",
        "paths": [
          "/products/*",
          "/help",
          "/profile/*",
          "/orders/*"
        ]
      }
    ]
  }
}

func application(_ application: UIApplication,
                continue userActivity: NSUserActivity,
                restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {

    guard userActivity.activityType == NSUserActivityTypeBrowsingWeb,
          let incomingURL = userActivity.webpageURL
    else {
        return false
    }

    // Parse the URL and navigate to appropriate screen
    handleUniversalLink(url: incomingURL)
    return true
}

private func handleUniversalLink(url: URL) {
    let path = url.path

    if path.hasPrefix("/products/") {
        let productId = path.replacingOccurrences(of: "/products/", with: "")
        // Navigate to product detail screen
        navigateToProduct(id: productId)
    } else if path == "/profile" {
        // Navigate to profile screen
        navigateToProfile()
    }
}

<activity android:name=".MainActivity">
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="https"
              android:host="yourdomain.com"
              android:pathPrefix="/products" />
    </intent-filter>

    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="https"
              android:host="yourdomain.com"
              android:pathPrefix="/profile" />
    </intent-filter>
</activity>

[{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.example.myapp",
    "sha256_cert_fingerprints": [
      "12:34:56:78:90:AB:CD:EF:12:34:56:78:90:AB:CD:EF:12:34:56:78:90:AB:CD:EF:12:34:56:78:90:AB:CD:EF"
    ]
  }
}]

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    handleIntent(getIntent());
}

@Override
protected void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    handleIntent(intent);
}

private void handleIntent(Intent intent) {
    String action = intent.getAction();
    Uri data = intent.getData();

    if (Intent.ACTION_VIEW.equals(action) && data != null) {
        String path = data.getPath();

        if (path.startsWith("/products/")) {
            String productId = path.substring(10); // Remove "/products/"
            openProductDetail(productId);
        } else if (path.equals("/profile")) {
            openProfile();
        }
    }
}

dependencies:
  flutter:
    sdk: flutter
  go_router: ^17.0.1

import 'package:flutter/material.dart';
import 'package:go_router/go_router.dart';

void main() => runApp(const MyApp());

final GoRouter router = GoRouter(
  routes: <RouteBase>[
    GoRoute(
      path: '/',
      builder: (context, state) => const HomeScreen(),
    ),
    GoRoute(
      path: '/products/:id',
      builder: (context, state) {
        final productId = state.pathParameters['id']!;
        final ref = state.uri.queryParameters['ref']; // optional
        return ProductScreen(productId: productId, ref: ref);
      },
    ),
    GoRoute(
      path: '/profile',
      builder: (context, state) => const ProfileScreen(),
    ),
  ],
);

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp.router(routerConfig: router);
  }
}

// Example screens (replace with your own widgets)
class HomeScreen extends StatelessWidget {
  const HomeScreen({super.key});

  @override
  Widget build(BuildContext context) {
    return const Scaffold(body: Center(child: Text('Home')));
  }
}

class ProductScreen extends StatelessWidget {
  const ProductScreen({super.key, required this.productId, this.ref});

  final String productId;
  final String? ref;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Product')),
      body: Center(
        child: Text('Product ID: $productId\nref: $ref'),
      ),
    );
  }
}

class ProfileScreen extends StatelessWidget {
  const ProfileScreen({super.key});

  @override
  Widget build(BuildContext context) {
    return const Scaffold(body: Center(child: Text('Profile')));
  }
}

final ValueNotifier<bool> isLoggedIn = ValueNotifier<bool>(false);

final GoRouter router = GoRouter(
  refreshListenable: isLoggedIn,
  redirect: (context, state) {
    final goingToProfile = state.uri.path == '/profile';
    if (!isLoggedIn.value && goingToProfile) {
      final from = Uri.encodeComponent(state.uri.toString());
      return '/login?from=$from';
    }
    return null;
  },
  routes: <RouteBase>[
    GoRoute(
      path: '/login',
      builder: (context, state) => const LoginScreen(),
    ),
    // ...other routes like /profile, /products/:id, etc.
  ],
);

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Get Our App</title>
    <style>
        body {
            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
            max-width: 400px;
            margin: 50px auto;
            padding: 20px;
            text-align: center;
            background: #f8f9fa;
        }
        .app-icon {
            width: 80px;
            height: 80px;
            border-radius: 16px;
            margin-bottom: 20px;
            background: #007AFF;
            display: flex;
            align-items: center;
            justify-content: center;
            color: white;
            font-size: 32px;
            margin: 0 auto 20px;
        }
        .download-buttons {
            display: flex;         
            justify-content: center;   
            align-items: center;     
            gap: 10px;                
            flex-wrap: nowrap;  
        }
        .download-btn {
            display: inline-block;
            padding: 12px 24px;
            background: #007AFF;
            color: white;
            text-decoration: none;
            border-radius: 8px;
            font-weight: 500;
            transition: opacity 0.2s;
        }
        .download-btn:hover {
            opacity: 0.8;
        }
        .download-btn.android {
            background: #34A853;
        }
        .card {
            background: white;
            border-radius: 16px;
            padding: 32px;
            box-shadow: 0 4px 12px rgba(0,0,0,0.1);
        }
    </style>
</head>
<body>
    <div class="card">
        <div class="app-icon">📱</div>
        <h1>Get Our App</h1>
        <p>For the best experience, download our mobile app:</p>
        
        <div class="download-buttons">
            <a href="https://apps.apple.com/app/idXXXXXXXX" aria-label="Download on the App Store" class="hover:scale-105 transition-all duration-200 transform">
                <img src="https://www.svgrepo.com/show/303128/download-on-the-app-store-apple-logo.svg"
                    alt="Download on the App Store" width="180" />
            </a>

            <a href="https://play.google.com/store/apps/details?id=com.example.myapp" aria-label="Get it on Google Play" class="hover:scale-105 transition-all duration-200 transform">
                <img src="https://www.svgrepo.com/show/303139/google-play-badge-logo.svg"
                    alt="Get it on Google Play" width="180" />
            </a>
        </div>

        <p><small>Or <a href="/web-version" class="hover:text-asee-blue hover:scale-105 transition-all duration-200 transform">continue in browser</a></small></p>
    </div>
</body>
</html>