flutter-setup-declarative-routing

Add go_router with flutter pub add, define a top-level GoRouter instance with your route tree, and pass it to MaterialApp.router via the routerConfig parameter. Call usePathUrlStrategy in main to remove the hash fragment from web URLs.

On Android, add an intent filter with autoVerify in AndroidManifest.xml and host assetlinks.json at your domain's .well-known path. On iOS, enable FlutterDeepLinkingEnabled in Info.plist, add associated domains to entitlements, and host the apple-app-site-association file.

On Android, use adb shell with am start and an ACTION_VIEW intent targeting your URL and package name. On iOS, run xcrun simctl openurl booted followed by the deep link URL on a booted simulator.

Yes, go_router supports persistent shells through StatefulShellRoute.indexedStack, which keeps each navigation branch's state alive. You build the shell UI with a StatefulNavigationShell and switch branches via navigationShell.goBranch.

Flutter's built-in deep link handler can conflict with plugins like app_links that intercept the same URLs. Set FlutterDeepLinkingEnabled to NO in Info.plist when using a third-party deep linking plugin to prevent double handling.