vue-router
5.5.1 · 13 Nov 2026MIT13.4M / weekRepositoryHomepagenpmAtom feed
151 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
- 4.x
4.0.1 – 4.0.1212 releases without a noteShow each
4.0.0
7 Dec 2020History implementation: handles the address bar and is specific to the environment Vue Router runs on (Node, Browser, Mobile, etc)
Router Matcher: Handles the parsing of routes
/users/:idand its rankingRouter: Connects everything together and handle routing specific features like navigation guards
A more complete but lighter Router
Today Vue Router 4 is officially released as stable.
After 14 alphas, 13 betas and 6 release candidates, Vue Router v4 is ready to bring the best of routing to your Vue 3 applications with improved bundle size, TypeScript integration, new features and consistency improvements for modern apps.It has taken almost 2 years of work, around 1500 commits, 15 RFCs, and the help of many users and their bug reports and feature requests to get here. Thank you all for your very much appreciated help!
Project Organization improvements
Vue Router is now divided in three modules:
History implementation: handles the address bar and is specific to the environment Vue Router runs on (Node, Browser, Mobile, etc)
Router Matcher: Handles the parsing of routes
/users/:idand its rankingRouter: Connects everything together and handle routing specific features like navigation guards
Dynamic Routing
One the most wanted features on Vue Router is Dynamic Routing. It makes the router more flexible and powerful and open possibilities for applications that were not possible before! This is possible thanks to an advanced path parsing with automatic ranking, allowing the router to guess what route should be matched based on the URL string representation, allowing user to define routes in any order.
Improved Navigation system
The new navigation system is more consistent and improves the experience of Scroll Behavior to match native browser behavior. It also gives users almost more information about the status of a navigation and allow using that information to improve user experience through global UI elements like progress bars and modals.
More powerful Devtools
Thanks to the new Vue Devtools, Vue Router is able to create more advanced integrations: navigation in the timeline and a complete route directory that helps you debug routes.
Better Navigation guards
Say good bye to
nextand avoid easy-to-make mistakes inside navigation guards: return any value you were passing tonext. The previous version is still supported to ease migration!More information on the updated documentation.
Consistent encoding in routes
Encoding has been adapted to make it consistent across different browsers and route location properties (
params,queryandhash). You don't need to encode these properties when passing them torouter.push()and they will always appear decoded in the route locations (e.g.$routeanduseRoute()).Small migration path
Vue Router 4 focus on improving the existing Router while keeping a very similar API, migration should be short and almost limited to a few renames if you were using the basics of Vue Router. You can check the full migration guide on the documentation
The future of the Router
Vue Router has been effectively stable for the past couple of months and makes it possible to now focus on:
Better Developer experience with existing tooling (Vetur, Vite, Devtools, etc)
Better integration with modern features like Suspense
RFCs to improve the existing API or bring new ones
Lighter versions of the router
Trying It Out
If you want to give Vue Router 4 a quick try, you can check this CodeSandbox, this Vite template with Tailwind CSS, or use the CLI to get started.
To Learn more about Vue Router 4, check out our new documentation. If you are an existing Vue 2.x user, go directly to the Migration Guide.
Supporting Vue Router Development
If your company uses Vue Router, please consider supporting its development by supporting me 🙏 . It will mean a lot and really help me to keep working on improving the Vue Ecosystem.
If you were already using the release candidate version of vue router, you can find the list of improvements on the CHANGELOG.md.
- 3.x
3.0.5 – 3.6.537 releases without a noteShow each
- 3.6.56 Sep 2022no note
- 3.6.425 Aug 2022no note
- 3.6.323 Aug 2022no note
- 3.6.223 Aug 2022no note
- 3.6.123 Aug 2022no note
- 3.6.022 Aug 2022no note
- 3.5.416 May 2022no note
- 3.5.326 Oct 2021no note
- 3.5.221 Jun 2021no note
- 3.5.126 Jan 2021no note
- 3.5.025 Jan 2021no note
- 3.4.95 Nov 2020no note
- 3.4.826 Oct 2020no note
- 3.4.716 Oct 2020no note
- 3.4.67 Oct 2020no note
- 3.4.526 Sep 2020no note
- 3.4.424 Sep 2020no note
- 3.4.311 Aug 2020no note
- 3.4.27 Aug 2020no note
- 3.4.16 Aug 2020no note
- 3.4.05 Aug 2020no note
- 3.3.413 Jun 2020no note
- 3.3.312 Jun 2020no note
- 3.3.229 May 2020no note
- 3.3.127 May 2020no note
- 3.3.027 May 2020no note
- 3.2.019 May 2020no note
- 3.1.626 Feb 2020no note
- 3.1.515 Jan 2020no note
- 3.1.414 Jan 2020no note
- 3.1.330 Aug 2019no note
- 3.1.28 Aug 2019no note
- 3.1.16 Aug 2019no note
- 3.1.06 Aug 2019no note
- 3.0.73 Jul 2019no note
- 3.0.617 Apr 2019no note
- 3.0.515 Apr 2019no note
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.