Fixed #

• Fixed RouteDefinition assertion error in _runGuards() when evaluating guards
  • Changed RouteDefinition(path: location) to RouteDefinition.stub(location)
  • This was causing crashes when authenticated users navigated to protected routes

Fixed #

• Shortened package description to meet pub.dev guidelines (60-180 characters)
• Renamed example file to example.dart for pub.dev discovery
• Expanded go_router version constraint to support v15-v17

Breaking Changes #

• AuthenticationGuard → RiverpodAuthenticationGuard
• RoleGuard → RiverpodRoleGuard
• RouterAdapter interface extended (implementers must add new methods)

Added #

• Named navigation: goNamed, pushNamed, replaceNamed
• Type-safe navigation with TypedRoute
• NavBridgeRoute - router-agnostic route definitions
• NavBridgeShellRoute - shell/tab navigation
• GuardOrchestrator - automatic guard management
• NavBridgeNavigationService - navigation service with modals
• RouteParams - type-safe parameter access
• GoRouterAdapter.fromRoutes factory

Deprecated #

• AuthenticationGuard (use RiverpodAuthenticationGuard)
• RoleGuard (use RiverpodRoleGuard)

Major Release - Enterprise Ready #

This release introduces Wrap Mode and Progressive Migration, making Nav Bridge adoptable by existing enterprise applications without requiring a full rewrite.

Added #

Core Features

• Wrap Mode: GoRouterAdapter.wrap() - wrap existing GoRouter without changes
• GuardContext with DI: Full dependency injection support via extras map
• Riverpod Support: RiverpodRouteGuard base class with Ref access
• Guard Bridges: Adapt existing guards without modifications
  • GoRouterGuardBridge - for guards with (BuildContext, GoRouterState, Ref)
  • SimpleGoRouterGuardBridge - for guards without Ref
  • GoRouterRedirectBridge - for redirect functions
  • GuardManagerBridge - for guard manager patterns
• InMemoryAdapter: Unit test navigation without Flutter UI
• Shell Navigation: Full StatefulShellRoute support

Guard System

• GuardResult sealed class with allow(), redirect(), reject()
• Guard priority system (higher priority runs first)
• appliesTo and excludes pattern matching
• CompositeGuard (AND logic) and AnyGuard (OR logic)

Testing

• InMemoryAdapter with navigation history tracking
• NavigationEvent recording for detailed test assertions
• Mock-friendly guard interfaces

Migration Guide #

From v1.x

If you were using v1.x, the migration is straightforward:

// v1.x - Required creating new router
final adapter = GoRouterAdapter.create(routes: [...]);

// v2.0 - Can wrap existing router (recommended)
final adapter = GoRouterAdapter.wrap(existingGoRouter);

For New Adopters

See the README for the progressive migration guide.

Breaking Changes #

• GuardResult is now a sealed class (use pattern matching)
• canActivate now receives GuardContext instead of individual parameters

Added #

• Initial release
• Basic GoRouterAdapter with create mode
• RouteGuard base class
• RouteDefinition for route configuration
• InMemoryAdapter for testing

Upcoming #

• AutoRoute adapter
• Typed route code generation
• Analytics observers

• Beamer adapter
• Transition abstraction
• Deep link validation