> flutter-auto-route-navigation

Typed routing, nested routes, and guards using auto_route. Use when implementing typed navigation, nested routes, or route guards with auto_route in Flutter. (triggers: **/router.dart, **/app_router.dart, AutoRoute, AutoRouter, router, guards, navigate, push)

fetch
$curl "https://skillshub.wtf/HoangNguyen0403/agent-skills-standard/flutter-auto-route-navigation?format=md"
SKILL.mdflutter-auto-route-navigation

AutoRoute Navigation

Priority: P1 (HIGH)

Type-safe routing system with code generation using auto_route.

Structure

core/router/
├── app_router.dart # Router configuration
└── app_router.gr.dart # Generated routes

Implementation Guidelines

  • @RoutePage: Annotate all screen/page widgets with @RoutePage().

  • Router Config: Extend _$AppRouter and annotate with @AutoRouterConfig.

  • Typed Navigation: Use generated route classes (e.g., HomeRoute()). Never use strings.

  • Nested Routes & Tabs: Use children in AutoRoute for tabs. When navigating to a route with nested tabs, use the children parameter to define the initial active sub-route (e.g., context.navigateTo(OrdersTabRoute(children: [ViewByOrdersPageRoute()]))).

  • Guards: Implement AutoRouteGuard for authentication/authorization logic.

  • Parameters: Constructors of @RoutePage widgets automatically become route parameters.

  • Declarative: Prefer context.pushRoute() or context.replaceRoute().

Reference & Examples

For full Router configuration and Auth Guard implementation: See references/REFERENCE.md.

Related Topics

go-router-navigation | layer-based-clean-architecture

🚫 Anti-Patterns

  • Do NOT use standard patterns if specific project rules exist.
  • Do NOT ignore error handling or edge cases.

┌ stats

installs/wk0
░░░░░░░░░░
github stars341
██████████
first seenMar 17, 2026
└────────────

┌ repo

HoangNguyen0403/agent-skills-standard
by HoangNguyen0403
└────────────

┌ tags

└────────────