PackageTrack
Sign in Get early access

go_router

A declarative router for Flutter based on Navigation 2 supporting deep linking, data-driven routes and more

17.5.0 3.8M downloads/mo #167 most downloaded on pub.dev flutter/packages

What this package is like to depend on

Last release 13 days ago

10 Aug 2026

Ships fairly regularly

a new release about every 4 weeks

Nearly every release is documented

notes for 243 of 245 stable releases

6 versions withdrawn

withdrawn after publishing

5 years old

251 releases · first in 2021

16 releases in the last 12 months

see the full history below

Release timeline

251 releases · May 2021 to Aug 2026
2022 2023 2024 2025 2026
Release Pre-release Withdrawn

Releases

latest 60 of 251
  1. 17.5.0 10 Aug 2026
    Release notes
    • Adds route metadata support, including inheritance and override behavior with exposure on GoRouterState.
    • Documents support for regular expression constraints in GoRoute path parameters.
    Open source →
  2. 17.4.0 04 Aug 2026
    Release notes
    • Fixes onExit ignored for GoRoute nested inside ShellRoute
    • Adds BlockedInitialNavigationException (a GoException subtype), raised when the initial navigation is blocked by onEnter with no prior route to restore, so apps can distinguish this case in onException without string matching.
    Open source →
  3. 17.3.0 02 Jun 2026
    Release notes
    • Updates minimum supported SDK version to Flutter 3.38/Dart 3.10.
    • Adds hasOverriddenOnExit parameter to GoRouteData.$route and RelativeGoRouteData.$route helper methods for type-safe routes. When set to true, enables custom onExit callback invocation from route data classes extending GoRouteData or RelativeGoRouteData when the route is removed from the navigation stack.
    Open source →
  4. 17.2.3 01 May 2026
    Release notes
    • Fixes an assertion failure when navigating to URLs with hash fragments missing a leading slash.
    Open source →
  5. 17.2.2 20 Apr 2026
    Release notes
    • Fixes pop() restoring stale configuration when route has onExit, which could cause the popped route to reappear with async redirects.
    Open source →
  6. 17.2.1 13 Apr 2026
    Release notes
    • Fixes chained top-level redirects not being fully resolved (e.g. / → /a → /b stopping at /a).
    • Fixes route-level redirects not triggering top-level redirect re-evaluation on the new location.
    Open source →
  7. 17.2.0 02 Apr 2026
    Release notes
    • Fixes Block.then() and Allow.then() navigation callbacks being silently lost when triggered by refreshListenable due to re-entrant route processing.
    • Adds encoder, decoder and compare parameters to TypedQueryParameter annotation for custom encoding, decoding and comparison of query parameters in TypedGoRoute constructors.
    Open source →
  8. 17.1.0 03 Feb 2026
    Release notes
    • Adds TypedQueryParameter annotation to override parameter names in TypedGoRoute constructors.
    Open source →
  9. 17.0.1 10 Dec 2025
    Release notes
    • Fixes an issue where onEnter blocking causes navigation stack loss (stale state restoration).
    • Updates minimum supported SDK version to Flutter 3.32/Dart 3.8.
    Open source →
  10. 17.0.0 06 Nov 2025
    Release notes
    • BREAKING CHANGE
      • ShellRoute's navigating changes notify GoRouter's observers by default.
      • Adds notifyRootObserver to ShellRouteBase, ShellRoute, StatefulShellRoute, ShellRouteData.$route, TypedShellRoute, TypedStatefulShellRoute.
    Open source →
  11. 16.3.0 22 Oct 2025
    Release notes
    • Adds a top-level onEnter callback with access to current and next route states.
    Open source →
  12. 16.2.5 15 Oct 2025
    Release notes
    • Fixes GoRouter.of(context) access inside redirect callbacks by providing router access through Zone-based context tracking.
    • Adds support for using context extension methods (e.g., context.namedLocation(), context.go()) within redirect callbacks.
    Open source →
  13. 16.2.4 23 Sep 2025
    Release notes
    • Fix Android Cold Start deep link with empty path losing scheme and authority.
    Open source →
  14. 16.2.3 23 Sep 2025
    Release notes
    • Fixes an issue where iOS back gesture pops entire ShellRoute instead of the active sub-route.
    Open source →
  15. 16.2.2 20 Sep 2025
    Release notes
    • Fixes broken links in readme.
    Open source →
  16. 16.2.1 29 Aug 2025
    Release notes
    • Adds state restoration topic to documentation.
    Open source →
  17. 16.2.0 18 Aug 2025
    Release notes
    • Adds RelativeGoRouteData and TypedRelativeGoRoute.
    • Updates minimum supported SDK version to Flutter 3.29/Dart 3.7.
    Open source →
  18. 16.1.0 04 Aug 2025
    Release notes
    • Adds annotation for go_router_builder that enable custom string encoder/decoder #110781. Requires go_router_builder >= 3.1.0.
    Open source →
  19. 16.0.0 01 Jul 2025
    Release notes
    • BREAKING CHANGE
      • Bump major version for GoRouteData breaking changes.
      • (Previously 15.2.4) Fixes routing to treat URLs with different cases (e.g., /Home vs /home) as distinct routes.
      • (Previously 15.2.3) Updates Type-safe routes topic documentation to use the mixin from go_router_builder 3.0.0.
      • (Previously 15.2.2) Fixes calling PopScope.onPopInvokedWithResult in branch routes.
      • (Previously 15.2.1) Fixes Popping state and re-rendering scaffold at the same time doesn't update the URL on web.
      • (Previously 15.2.0) GoRouteData now defines .location, .go(context), .push(context), .pushReplacement(context), and replace(context) to be used for Type-safe routing. Requires go_router_builder >= 3.0.0.
    Open source →
  20. 15.2.4 24 Jun 2025 withdrawn

    Nothing published for this version

  21. 15.2.3 19 Jun 2025 withdrawn

    Nothing published for this version

  22. 15.2.2 19 Jun 2025 withdrawn

    Nothing published for this version

  23. 15.2.1 18 Jun 2025 withdrawn

    Nothing published for this version

  24. 15.2.0 12 Jun 2025 withdrawn

    Nothing published for this version

  25. 15.1.3 06 Jun 2025
    Release notes
    • Updates minimum supported SDK version to Flutter 3.27/Dart 3.6.
    • Fixes typo in API docs.
    Open source →
  26. 15.1.2 08 May 2025
    Release notes
    • Fixes focus request propagation from GoRouter to Navigator by properly handling the requestFocus parameter.
    Open source →
  27. 15.1.1 22 Apr 2025
    Release notes
    • Adds missing caseSensitive to GoRouteData.$route.
    Open source →
  28. 15.1.0 21 Apr 2025
    Release notes
    • Adds caseSensitive to TypedGoRoute.
    Open source →
  29. 15.0.0 16 Apr 2025
    Release notes
    • BREAKING CHANGE
      • URLs are now case sensitive.
      • Adds caseSensitive parameter to GoRouter (default to true).
      • See Migrating to 15.0.0
    Open source →
  30. 14.8.1 26 Feb 2025
    Release notes
    • Secured canPop method for the lack of matches in routerDelegate's configuration.
    Open source →
  31. 14.8.0 07 Feb 2025
    Release notes
    • Adds preload parameter to StatefulShellBranchData.$branch.
    Open source →
  32. 14.7.2 28 Jan 2025
    Release notes
    • Add missing await keyword to onTap callback in navigation.md.
    Open source →
  33. 14.7.1 24 Jan 2025
    Release notes
    • Fixes return type of current state getter on GoRouter and GoRouterDelegate to be non-nullable.
    Open source →
  34. 14.7.0 25 Jan 2025
    Release notes
    • Adds fragment support to GoRouter, enabling direct specification and automatic handling of fragments in routes.
    Open source →
  35. 14.6.3 06 Jan 2025
    Release notes
    • Updates minimum supported SDK version to Flutter 3.22/Dart 3.4.
    • Updates readme.
    Open source →
  36. 14.6.2 03 Dec 2024
    Release notes
    • Replaces deprecated collection method usage.
    Open source →
  37. 14.6.1 21 Nov 2024
    Release notes
    • Fixed PopScope, and WillPopScop was not handled properly in the Root routes.
    Open source →
  38. 14.6.0 13 Nov 2024
    Release notes
    • Allows going to a path relatively by prefixing ./
    Open source →
  39. 14.5.0 12 Nov 2024
    Release notes
    • Adds preload support to StatefulShellRoute, configurable via preload parameter on StatefulShellBranch.
    Open source →
  40. 14.4.1 04 Nov 2024
    Release notes
    • Adds missing_code_block_language_in_doc_comment lint.
    Open source →
  41. 14.4.0 04 Nov 2024
    Release notes
    • Adds current state getter on GoRouter that returns the current GoRouterState.
    Open source →
  42. 14.3.0 04 Oct 2024
    Release notes
    • Adds missing implementation for the routerNeglect parameter in GoRouter.
    Open source →
  43. 14.2.9 03 Oct 2024
    Release notes
    • Relaxes route path requirements. Both root and child routes can now start with or without '/'.
    Open source →
  44. 14.2.8 24 Sep 2024
    Release notes
    • Updated custom_stateful_shell_route example to better support swiping in TabView as well as demonstration of the use of PageView.
    Open source →
  45. 14.2.7 23 Aug 2024
    Release notes
    • Fixes issue so that the parseRouteInformationWithContext can handle non-http Uris.
    Open source →
  46. 14.2.6 20 Aug 2024
    Release notes
    • Fixes replace and pushReplacement uri when only one route match in current route match list.
    Open source →
  47. 14.2.5 20 Aug 2024
    Release notes
    • Fixes an issue where android back button pops pages in the wrong order.
    Open source →
  48. 14.2.3 05 Aug 2024
    Release notes
    • Fixes redirect example's signature in route.dart.
    Open source →
  49. 14.2.2 01 Aug 2024
    Release notes
    • Adds section for "Stateful nested navigation" to configuration.md.
    Open source →
  50. 14.2.1 11 Jul 2024
    Release notes
    • Makes GoRouterState lookup more robust.
    Open source →
  51. 14.2.0 13 Jun 2024
    Release notes
    • Added proper redirect handling for ShellRoute.$route and StatefulShellRoute.$route for proper redirection handling in case of code generation.
    Open source →
  52. 14.1.4 28 May 2024
    Release notes
    • Fixes a URL in navigation.md.
    Open source →
  53. 14.1.3 21 May 2024
    Release notes
    • Improves the logging of routes when debugLogDiagnostics is enabled or `debugKnownRoutes() is called. Explains the position of shell routes in the route tree. Prints the widget name of the routes it is building.
    Open source →
  54. 14.1.2 17 May 2024
    Release notes
    • Fixes issue that path parameters are not set when using the goBranch.
    Open source →
  55. 14.1.1 14 May 2024
    Release notes
    • Fixes correctness of the state provided in the onExit.
    Open source →
  56. 14.1.0 09 May 2024
    Release notes
    • Adds route redirect to ShellRoutes
    Open source →
  57. 14.0.2 29 Apr 2024
    Release notes
    • Fixes unwanted logs when hierarchicalLoggingEnabled was set to true.
    Open source →
  58. 14.0.1 25 Apr 2024
    Release notes
    • Updates the redirection documentation for clarity
    Open source →
  59. 14.0.0 24 Apr 2024
    Release notes
    • BREAKING CHANGE
      • GoRouteData's onExit now takes 2 parameters BuildContext context, GoRouterState state.
    Open source →
  60. 13.2.5 24 Apr 2024

    Nothing published for this version

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive