flutter-navigation

name	flutter-navigation
description	Flutter navigation patterns including go_router, deep linking, and named routes. Use when implementing navigation, deep linking, or named routes in Flutter. (triggers: **/*_route.dart, **/*_router.dart, **/main.dart, Navigator, GoRouter, routes, deep link, go_router, AutoRoute)

Flutter Navigation

Priority: P1 (OPERATIONAL)

Navigation and routing for Flutter apps using go_router or named routes.

Guidelines

• Package: Use go_router for modern, declarative routing.
• Deep Linking: Configure AndroidManifest.xml and Info.plist for URL schemes.
• Validation: Validate parameters in redirect logic before navigation.
• Stateful Tabs: Use IndexedStack to preserve state in bottom navigation.

Routing Patterns & Examples

Anti-Patterns

• No Manual URL Parsing: Use go_router parsing, never Uri.parse manually.
• No Stateless Tabs: Scaffold body switching loses state; use IndexedStack.
• No Unvalidated Deep Links: Always check if IDs exist in redirect.
• No Hardcoded Routes: Use constants (e.g., Routes.home) or code generation.

Related Topics

flutter-design-system | flutter-notifications | mobile-ux-core