Annotate pages — Mark all screen/page widgets with @RoutePage().
Configure router — Extend _$AppRouter and annotate with @AutoRouterConfig.
Navigate with types — Use generated route classes (e.g., HomeRoute()). Never use strings.
Add guards — Implement AutoRouteGuard for authentication/authorization logic.
Handle parameters — Constructors of @RoutePage widgets automatically become route parameters.
Prefer declarative calls — Use context.pushRoute() or context.replaceRoute().

Use children in AutoRoute for tabs. Pass children parameter to define initial active sub-route.

See implementation examples for nested route navigation and router configuration patterns.

Reference & Examples

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

Anti-Patterns

No string-based navigation: Use generated typed route classes (e.g., OrderDetailRoute(id: 123)).
No protected screen without AutoRouteGuard: Every protected route must declare guard; don't rely on UI-level checks.
No navigation calls from BLoC: Emit state and let Presentation layer navigate.

When this skill applies, preserve the following domain terminology or equivalent concrete examples in the answer when relevant: