Flutter Navigation and Routing

When to use

Invoke when adding navigation to a scaffolded Flutter app, hardening an existing navigation graph (deep-link validation, auth-gate correctness, restoration after process death), or resolving notification payloads to routes.

Do not use for: app scaffolding or the router placeholder itself (use flutter-app-scaffold-and-runtime); state management, token storage/refresh, or push payload ingestion (use flutter-state-and-data-fetching); design-system or accessibility integration (use flutter-design-system-and-accessibility); performance budget enforcement (use flutter-performance-and-reliability).

Inputs

Required:

• A scaffolded Flutter app with the app/app.dart router placeholder and the // TODO(flutter-navigation-and-routing) seams.
• Approved mobile-architecture.md, or explicit confirmation that mobile architecture is intentionally deferred.

Optional: