auto_route_generator
AutoRoute is a declarative routing solution, where everything needed for navigation is automatically generated for you.
10.6.0
362K downloads/mo
#612 most downloaded on pub.dev
Milad-Akarie/auto_route_library
What this package is like to depend on
Last release 2 months ago
13 Jun 2026
Ships fairly regularly
a new release about every 3 months
Some releases are documented
notes for 40 of 90 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
102 releases · first in 2019
7 releases in the last 12 months
see the full history below
Release timeline
102 releases · Dec 2019 to Jun 2026Releases
latest 60 of 102-
10.6.013 Jun 2026Release notes
Open source →- CHORE: update analyzer constraints to support versions >=10.0.0 <14.0.0
- CHORE: update lean_builder dependency to ^1.2.0
-
10.5.013 Feb 2026 -
10.4.030 Nov 2025 -
10.3.130 Nov 2025Release notes
Open source →- REFACTOR: Update analyzer dependency and migrate from
element2toelement
- REFACTOR: Update analyzer dependency and migrate from
-
10.3.027 Nov 2025 -
10.2.612 Nov 2025 -
10.2.517 Oct 2025Release notes
Open source →- FIX: respect page.opaque for transparent route.
- FIX: handle dart:xxx.xxx.dart imports in type resolution (af60d79) when using lean_builder
- REFACTOR: introduce _genericRef function for improved type reference handling (d5ecf13)
- FIX: respect page.opaque for transparent route (52b71b7)
- FIX: Use immutable array for pending child routes, fixes #2210 (beb3ce0)
- CHORE:: extend support to analyzer 8 (b2cb61d)
-
10.2.416 Aug 2025Release notes
Open source →- CHORE: tidy up dependencies and sync with updated analyzer version.
- FIX: Add indexed stack semantics
- FIX: Allow PopCompleter to complete during route reevaluation when pop-completers are disabled
-
10.2.328 May 2025 -
10.2.228 May 2025Release notes
Open source →- FIX: predictive back gesture known issues.
- FIX: update predictive_back_page_detector.dart to resolve predictive back and swipe issues.
2025-10-17
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
auto_route_generator-v10.2.5
Release notes
Open source →- FIX: Fix files with no @RoutePage annotation should not generate empty output when using lean_builder;
-
10.2.128 May 2025 -
10.2.028 May 2025Release notes
Open source →- REFACTOR: update element references and improve method signatures for clarity.
- REFACTOR: remove redundant formatting in generated code.
- REFACTOR: Improve tab navigation and observer logic.
- FIX: respect page.opaque for transparent route.
- FIX: meta import.
- FIX: Allow PopCompleter to complete during route reevaluation.
- FIX(reevaluate): ensure _isReevaluating is reset after reevaluation.
- FIX: improve focus and semantics handling in AutoTabsRouter.
- FIX: default argsEquality to true for route args and update related documentation.
- FIX: respect argsEquality config in PageRouteInfo == operator.
- FIX: Generated code is not properly formatted.
- FEAT: Add experimental support for lean_builder.
- FEAT: expose routeTraversalEdgeBehavior.
- DOCS: improve LeanBuilder section in README.
- DOCS: improve LeanBuilder section in README.
2025-03-03
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
auto_route_generator-v10.0.2
-
10.1.025 May 2025Release notes
Open source →- FEAT: Expose routeTraversalEdgeBehavior property from the underlying Navigator to allow customization of navigation stack edge behavior.
- FIX: Improve focus and semantics handling in AutoTabsRouter IndexedStack to exclude inactive tabs from focus traversal and semantics tree while preserving widget state.
- FIX: Fix tab routes observing issue where initiating tabs can be reported twice.
- FIX: Fix a couple core reevaluation issues.
- FIX: Generated code is not properly formatted #2174
- FIX: Fixed PageRouteInfo equality check regression introduced in v10.0.1 when using code generation with argsEquality: false, which now defaults to true. The equality operator no longer compares args by default unless argsEquality: true is explicitly set in AutoRouterConfig. This restores compatibility with previous versions and prevents navigation test failures due to custom argument classes lacking a proper == override.
-
10.0.127 Feb 2025Release notes
Open source →- REFACTOR(custom_route): update route duration type from int to Duration.
- FIX: guard reevaluation issues #1993 #2151 #2100.
- FIX: Exposing clipBehavior for nested navigation #2082.
- FIX: When use AutoTabsRouter.tabBar, maintainState: false and TabBar together, fails to load routes in some cases #2113.
- FIX: Unexpected null value issue with context in provider model and AutoRouteGuard #1707.
- FIX: Unexpected null value issue with context in provider model and AutoRouteGuard #1707.
2024-08-12
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
auto_route_generator-v9.0.1
-
10.0.026 Feb 2025Release notes
Open source →- BREAKING CHANGE: DeepLink and DeepLink.path will now use 'navigate' instead of push unless specified
- FEAT: add support for using auto_route with out code generation using NamedRouteDef and NamedRoute otherwise.
- FEAT: optional args equality by setting AutoRouterConfig(argsEquality: true)
- FEAT: insert route method to StackRouter
- FIX: guard reevaluation was re-implemented to fix previous issues
- FEAT: expose Navigator.clipBehavior in both AutoRouterDelegate and AutoRouter
- FIX: using AutoTabsRouter.tabBar with maintainState: false and TabBar together, fails to load routes in some cases #2113
- FEAT: safe build context can now be accessed in AutoRouteGuard.onNavigation -> NavigationResolver.context
- FEAT: add a new way to override guarded routes using NavigationResolver.overrideNext
- FIX: AutoLeadingButton is not showing anything on a screen that combines AutoTabsScaffold and NestedRoute #2141
- FIX: redirect route doesn't pass query params the to redirectTo path
- FIX: generated PageRouteInfo breaks if widget tagged with @RoutePage parameter named children. #2149
- FEAT: add an AutoLeadingButton.builder to enable passing of nullable leading widget
- FIX: Fix a couple internal issues and migrate to using didRemovePage api
- FEAT: Parameters.getList now supports a default value
- FIX: Add required keyword to named required parameters in function parameters' arguments
- FIX: fix inheritPathParam didn't use the .inherit constructor
- REFACTOR rename a couple of apis (popForced -> pop, pushNamed -> pushPath, replaceNamed -> replacePath, navigateNamed -> navigatePath, pathParams -> params)
-
9.3.109 Jan 2025 -
9.3.008 Jan 2025Release notes
Open source →- CHORE: Bump source_gen (v2), dart_style (v3) versions.
- CHORE: Resolve some deprecated APIs.
-
9.0.030 Jul 2024Release notes
Open source →- BREAKING CHANGE: No Router class will be generated anymore. Instead, you
extend
RootStackRouterfrom theauto_routepackage. - BREAKING CHANGE: Providing return types inside
@RoutePage<Type>()is no longer needed. you just provide the type as you push the page. - BREAKING CHANGE: Providing a global route is now done by overriding the
guardsproperty inside the router. implementing AutoRouteGuard is no longer supported. - BREAKING CHANGE:
AutoRouterConfig.moduleis removed as it's no longer needed.PageRouteInfosare now self-contained.
For more info read the complete migration guide Migrating to v9
- FIX: Fix Aliased types are not generated correctly.
- FEAT: You can now create empty shell routes like follows:
final BooksTab = EmptyShellRoute('BooksTab'); context.push(BooksTab());
- BREAKING CHANGE: No Router class will be generated anymore. Instead, you
extend
-
8.1.016 Jul 2024Release notes
Open source →- FEAT: add url#fragment support.
2024-06-13
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
auto_route_generator-v8.0.1
Release notes
Open source →- FEAT: add url#fragment support.
- CHORE: update auto_route_generator dependencies
-
8.0.025 Mar 2024Release notes
Open source →- FEAT: AutoTabsRouter will now use the declared routes if AutoTabsRouter.routes is not provided, if of any of the tabs has required parameters it will throw an error.
- BREAKING CHANGE: deep-links with no host e.g scheme://page/sub-page are no longer automatically handled, flutter's deep-link handler will treat [page] as host so we end up with [/sub-page] as a path which of course not going to match. if your deep-links are hostless you'll need to handle them manually inside deepLinkBuilder.
-
7.3.205 Oct 2023Release notes
Open source →- DOCS: Add public Api docs to auto_route_generator.
2023-08-23
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
auto_route_generator-v7.3.2
-
7.3.112 Aug 2023Release notes
Open source →- DOCS: Add public Api docs to auto_route_generator.
2023-08-03
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Release notes
Open source →- DOCS: Add public Api docs to auto_route_generator.
- REFACTOR: Update analyzer constrains to support up to version 7.0.0
-
7.3.003 Aug 2023Release notes
Open source →- REFACTOR: generated routes are not alphabetically sorted.
- FEAT: add option to pass custom ignore_for_file rules to the generated file.
- FEAT: Add basic support to dart records.
2023-07-18
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
auto_route_generator-v7.2.1
Release notes
Open source →- REFACTOR: generated routes are now alphabetically sorted.
- FEAT: add option to pass custom ignore_for_file rules to the generated file.
-
7.2.005 Jul 2023Release notes
Open source →- FEAT: Add basic support to dart records.
2023-07-03
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Release notes
Open source →- FEAT: Add basic support to dart records.
- FIX: encoded path segments are not decoded in RouteMatch.pathParams
- FIX: encoded browser path is checked against a decoded matched path when deciding whether to replace route #1637
-
7.1.203 Jul 2023Release notes
Open source →- FIX: AutoRouteConfig.module() doesn't generate part of file correctly. #1626.
-
7.1.121 May 2023Release notes
Open source →- REFACTOR: change module extension from .module.dart to .gm.dart.
- DOCS: update CHANGELOG.md.
2023-05-20
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Release notes
Open source →- REFACTOR: change module extension from .module.dart to .gm.dart.
- update dart sdk constrains to ">=2.17.0 <4.0.0"
-
7.1.020 May 2023Release notes
Open source →- REVERT: "feat: add more flexible multi package support".
- REVERT: "cleanup".
- FEAT(auto_route_generator): expose the new
autoRouterModuleBuilderto the package surface. - FEAT(auto_route_generator): add
AutoRouterModuleBuilder. - FEAT(auto_route_generator): update code builder (add module support + rename).
- FEAT(auto_route_generator): update
RouterConfig+RouterConfigResolverto matchAutoRouterConfig.module. - FEAT: add more flexible multi package support.
2023-05-06
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
-
7.0.006 May 2023Release notes
Open source →- FEAT: add support to process files in micro-packages.
- DOCS: add all public api docs.
2023-05-06
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
auto_route_generator-v6.2.1
-
6.2.015 Apr 2023Release notes
Open source →- FIX: need to always depend on RouterScope.
- FIX: url state decode issue.
- FEAT: Add a getter to expose child widget from AutoRoutePage.
- FEAT: deferred loading for web to enable code splitting for routes.
-
6.1.009 Apr 2023Nothing published for this version
-
6.0.302 Apr 2023Nothing published for this version
-
6.0.229 Mar 2023Nothing published for this version
-
6.0.125 Mar 2023Nothing published for this version
-
6.0.019 Mar 2023Nothing published for this version
-
6.0.0-rc-114 Mar 2023 pre-releaseNothing published for this version
-
6.0.0-rc23 Feb 2023 pre-releaseRelease notes
Open source →make sure you check the Migration guide
- AutoRoute now takes a PageInfo object from the generated routes instead of Type
- Introduce @RoutePage() annotation to annotate routable widgets
- Routes are defined in the body of the router class instead of inside the annotation
- Remove replace @MaterialAutoRouter,@CupertinoAutoRouter ...etc with @AutoRouterConfig annotation
- Remove EmptyRouterPage & EmptyRouterScreen
- "initial" flag is removed now, use "/" for initial routes or empty path "" for nested-initial routes.
- Passing route guards is also changed now, instead of passing guards as types you now pass instances.
- Add title builder for AutoRoute(title: (ctx,data){})
- Docs are changed to reflect the new changes so make sure you re-read them.
-
5.0.312 Oct 2022Nothing published for this version
-
5.0.229 Aug 2022Nothing published for this version
-
5.0.122 Aug 2022Nothing published for this version
-
5.0.018 Aug 2022Nothing published for this version
-
4.2.103 Aug 2022Nothing published for this version
-
4.2.029 Jun 2022Nothing published for this version
-
4.0.009 May 2022Release notes
Open source →- Refactor AutoRedirectGuard [Breaking Change]
- Add AutoRouteAwareStateMixin to minimize boilerplate for AutoRouteAware states
- Add NoShadowCupertinoTransitionsBuilder to remove unwanted shadow in nested cupertino routes
- Add PageView support to AutoTabsRouter
- Add TabBar support to AutoTabsRouter
- Add custom builder support to AutoTabsRouter
- Remove AutoTabsRouter.declarative implementation (replaced with builder) [Breaking Change]
- AutoRouter.declarative routes now accepts a PendingRoutesHandler instead of context [Breaking Change]
- Fix wrapped routes are rebuilt everytime the stack changes
- Fix query params are not updated in Tab-Routes
- Add router.activeGuardObserver to access active guards. e.g to implement loading indicator
- Fix initial route is not showing when nested router is rebuilt
- Replace AutoBackButton with AutoLeadingButton to support drawer and close icons
-
3.2.315 Feb 2022Nothing published for this version
-
3.2.101 Jan 2022Nothing published for this version
-
3.2.012 Dec 2021Nothing published for this version
-
3.1.011 Nov 2021Nothing published for this version
-
3.0.118 Oct 2021Nothing published for this version
-
3.0.018 Oct 2021Nothing published for this version
-
2.4.127 Sep 2021Nothing published for this version
-
2.4.019 Sep 2021Nothing published for this version
-
2.3.209 Sep 2021Nothing published for this version
-
2.3.007 Aug 2021Nothing published for this version
-
2.1.005 May 2021 -
2.0.127 Apr 2021Release notes
Open source →- OnPopRoute includes a results object now. [Breaking]
- Required queryParams to either be nullable or have a default value
-
2.0.025 Apr 2021Release notes
Open source →breaking changes
- Remove usesTabsRouter property from AutoRoute as it's no longer needed.
- onGenerateRoutes is now shortened to just routes and initial routes are no longer pass
- Legacy generator is completely dropped now.
- Remove all legacy generator related flags.
- navigatorObservers is not a callback function that returns a list of observers
enhancements
- Bring back the good old await for pop results feature.
- The root AutoRouterDelegate can now be declarative.
- Push, replace and navigate will now bubble up if they can't be handled by the router they're called from.
- Enhance the navigate function to behave like navigating from the browser's bar.
- Add new methods to navigate by path pushNamed, replaceNamed and navigateNamed.
- Add AutoBackButton to handle nested routers popping with ease.
- Add some helper/shortcut methods to context extension, pushRoute, replaceRoute, navigateTo and popRoute.
- Add some helper methods to the RoutingController like popTop, topRoute and more.
- Pages will rebuild when an ancestor router updates if you depend on it.
- Add Auto RedirectRoute generation for Routes with none initial paths that's marked as initial.
- Add AutoRouteObserver to add tabs observing to the native observer.
- NavigatorObservers are now passed through a builder so nested navigators can inherit them.
- Add HeroControllerScope to nested AutoRouters
- Pomp up code_builder version to 4.0.0 and build_runner to 2.0.1
- Fix #458, #456 #421 and #453
- Minor fixes and enhancements
-
1.0.220 Mar 2021Nothing published for this version
-
1.0.117 Mar 2021Nothing published for this version
-
1.0.016 Mar 2021Nothing published for this version
-
1.0.0-beta.1114 Feb 2021 pre-releaseNothing published for this version