Released 2 months ago

πŸ› Bug Fixes

  • utils
  • #6777 Add catch statement to non function block in serializeFunction
  • #6791 Fix flatRoutes regex for nested routes with trailing slash enabled
  • vue-app
  • #6658 Pass router mode to getLocation
  • #6683 Apply path-to-regexp options to tokensToFunction
  • #6650 Layout in error.vue not work for Vue.extend component
  • #6623 Add prefetched class to <nuxt-link> after chunk loaded
  • general
  • #6685 context.route issue in plugins and splitChunks.pages === false
  • #6590 Collapsed SSR log
  • webpack
  • #6495 Enable devtool for dev mode
  • #6566 Normalize devtool for terser compatibility
  • config
  • #6583 Typo in unsafeInlineCompatibility name

πŸš€ Features

  • vue-app
  • #6722 Upgrade vue-router to 3.1.x
  • general
  • #6149 Optionally strip non-client or non-server code
  • vue-renderer
  • #6505 Support evaluation in templates
  • config
  • #6597 Add ignoreOptions for node-ignore

πŸ’… Refactors

  • server
  • #6771 Only append not empty allowed sources to csp

πŸ”₯ Performance

  • webpack
  • #6632 Prefer using contenthash

πŸ“ Examples

  • with-sockets
  • #6586 Fix cannot read property 'app' of undefined on nuxt build

🏑 Chore

  • general
  • #6732 Update @nuxtjs/eslint-config to v2 and fix lint errors
  • #6686 Fix typo in middleware readme
  • #6649 Limit stale bot to only issues
  • #6637 Remove unused dependencies
  • #6630 Use .github/config.yml for issue template
  • docs
  • #6719 Update code-of-conduct
  • ci
  • #6739 Remove coverage collection in fixtures
  • #6747 Use LTS Node.js instead of latest
  • #6737 Separate dev test and unit test
  • github
  • #6657 Add chinese translation for issue template

πŸ‘“ Tests

  • general
  • #6752 Pass array to allowedSources
  • #6740 Use got instead of request
  • #6638 Fix chrome detection in macOS Catalina
  • #6596 SSR log

πŸ’– Thanks to

  • Ahad Birang (@farnabaz)
  • Cain Hall (@cain)
  • Daniel Roe (@danielroe)
  • Dennis Herzberg (@dennis47528)
  • Harry TrαΊ§n (@jetaimefrc)
  • Mohammad M. Shahbazi (@mshahbazi)
  • @PedroD
  • Stephan Besser (@reskume)
  • RafaΕ‚ ChΕ‚odnicki (@rchl)
  • Vanessa A (@Vinesse)
  • @crutch12
Released 4 months ago

πŸ› Bug Fixes

  • webpack
  • #6495 Enable devtool for dev mode
  • #6566 Normalize devtool for terser compatibility
  • config
  • #6583 Typo in unsafeInlineCompatibility name
  • vue-app
  • #6590 Fix collapsed SSR log

πŸ“ Examples

  • with-sockets
  • #6586 Fix cannot read property 'app' of undefined on nuxt build

πŸ’– Thanks to

  • @PedroD
  • Stephan Besser (@reskume)
Released 4 months ago

🐞 Fixes

  • vue-app, webpack
  • #6504 Remove consola from client
  • utils
  • #6515 Fix error when router.trailingSlash is false
  • generator
  • #6362 Remove trailing slash when no subFolders are used
  • webpack
  • #6520 chunkhash and contenthash not work with extractCSS
  • cli
  • #6525 Enable server for nuxt build when pages should be generated

🏑 Chore

  • readme
  • #6511 Remove deprecated starter template

βš“ Dependency Upgrades

  • vue-meta: Upgraded to v2.3 which fixes duplicated tags in SPA mode

πŸ’– Thanks to

  • Dennis Herzberg (@dennis47528)
  • Yuki Terashima (@y-temp4)
Released 4 months ago


  • Support for improved typescript runtime
  • Experimental support for feature toggling for SUPER slim builds!
  • Mitigate problems with nuxt server stocking during development
  • Fix issues with internet-explorer in development mode
  • Upgrade to terser webpack plugin v2
  • Improved stability of loading-screen. No more endless loops (nuxt/loading-screen#44) and show fatal errors (nuxt/loading-screen#45) for the initial build

πŸ› Bug Fixes

  • core
  • #6490 Clear resolver cache for project files dev mode
  • vue-app
  • #6479 Error page layout not correctly applied in client-side rendering
  • #6473 Pass vm as arg to support data() with arrow function
  • #6433 Fix asyncData hydration when features.transition is false
  • #6430 Clear idle callback
  • #6217 Prevent looping on error during render of error page
  • webpack
  • #6298 Fix consola IE compatibility
  • Revert pause/resume
  • #6460 Correct sass options for [email protected]
  • #6448 Don't push to compilersWatching in callback
  • cli
  • #6441 Server should not be initialized in nuxt build
  • babel-preset-app
  • #6435 Use loose mode for babel class plugin
  • vue-renderer
  • #6429 Dont mutate options.head
  • config
  • #6371 Enable total timing by default when server.timing is enabled
  • config, vue-app
  • #6379 Add module declaration for config and vue-app

πŸš€ Features

  • cli, config
  • #6399 cli.bannerColor option
  • config
  • #6414 serverMiddleware as a simple key/value object
  • builder
  • #6368 followSymlinks option to allow for symlinks
  • #6285 extendPlugins option and builder:extendPlugins hook
  • #6329 Add builder:prepared hook
  • #6342 Support adding custom middleware
  • cli
  • #6475 Catch build errors with cli:buildError hook
  • webpack
  • #6477 Use vue-meta browser build for client bundle
  • #6398 Upgrade terser-webpack-plugin to v2
  • #6350 Add webpack:config hook
  • server
  • #6438 Add config option to define etag hash function
  • vue-app
  • #6292 Add prefetch prop to <nuxt-link>
  • #6287 Support configurable features
  • #6297 Function watchQuery
  • general
  • #6432 Support setting (non-essential) vue-meta options by user
  • utils
  • #6277 Export sort routes
  • builder, router
  • #6331 Enforce uniform trailing slash handling

πŸ’… Refactors

  • cli
  • #6353 Call setup hook in run command with more args
  • builder
  • #6352 Await build.createRoutes to allow async functions inside it
  • babel-preset-app
  • #6087 Simplify babel preset config

πŸ“ Examples

  • with-sockets
  • #6396 Create server inside the export function

🏑 Chore

  • general
  • Fix example in babel-preset-app readme
  • #6390 Lint vue-app templates
  • #6363 Rename setup hook to run:before

πŸ’– Thanks to

Released 6 months ago

πŸ› Bug Fixes

  • general
  • #6257 Improve watching experience for generated files
  • builder
  • #6283 fix(builder): apply overrides from app dir only
  • server
  • #6265 Treat https: null as https: undefined
  • nuxt-start
  • #6267 Add missing vue-client-only dependency
  • vue-app
  • #6264 Only overwrite leave listener when none provided or without done arg
  • #6255 Enforce default css when used with frameworks
  • config
  • #6258 Provide typescript backward compatibility

πŸ’… Refactors

Released 6 months ago

πŸ› Bug Fixes

  • vue-app
  • #6252 Provide typescript backward compatibility

πŸ“ Examples

  • CoffeeScript
  • #6248 Update module for using additionalExtensions

πŸ’– Thanks to

  • Artyom Bogomolov (@DevArtyom)
Released 6 months ago

⚠️ Important Notes

  • πŸ‘‰ Minimum required node version is 8.9.0
  • πŸ‘‰ Typescript support is now externalized. Refer to official docs and migration guide.
  • πŸ‘‰ vue-meta upgraded to 2.0.0. Please refer to the changelog to review notable changes.
  • πŸ‘‰ scrollBehavior option is deprecated in favor of app/router.scrollBehavior.js (#6055)
  • πŸ‘‰ devModules option is deprecated in favor of buildModules (#6203)

πŸ› Bug Fixes

  • general
  • #6118 Fix modulepreload warnings
  • #6075 Throw error when building failed in quiet mode
  • #6070 Support babel corejs config for modern mode
  • #6021 Babel polyfill can not be disabled
  • renderer
  • #6033 Correctly load nomodule scripts in safari 10
  • cli
  • #6020 Prevent both nuxt & nuxt-edge being installed
  • vue-app
  • #6012 Emit triggerScroll to support hash navigation
  • #5920 Fix font-size and make width bigger
  • #5891 Always finish transition.leave asynchronously
  • #5890 Fix position of the build indicator when page scrolled
  • vue-renderer
  • #6223 Call render:resourcesLoaded hook before createRenderer
  • #5964 Clone SPA meta to prevent cache modification
  • webpack
  • #5906 Extract css breaks hmr and source-maps

πŸš€ Features

  • cli
  • #6206 Export options
  • server
  • #6178 Allow passing loadingTimeout and other arguments to renderAndGetWindow
  • webpack
  • #6120 Allow function entries for build.transpile
  • vue-app
  • #6194 Add $nuxt.refresh
  • #6186 Use EventSource instead of WebSocket for build indicator
  • #6055 Support app/router.scrollBehavior.js and deprecate scrollBehavior
  • #5941 Add <client-only> alias for <no-ssr>
  • #5844 Allow customizing loading indicator
  • #6194 Add $nuxt.refresh() method or refresh the actual page asyncData and fetch
  • #6231 Export router options
  • #6222 Support functional watchQuery
  • vue-renderer
  • #5975 Add csp option for csp v1 compatibility
  • #6134 Support prepend/append body tags during ssr for all allowed tag types
  • typescript
  • #5858 Externalize typescript support

πŸ’… Refactors

  • config
  • #6203 Rename devModules to buildModules
  • babel-preset-app
  • #6197 Remove babel-plugin-dynamic-import-node
  • webpack
  • #6179 Simplify transpile normalization
  • general
  • Refactor to adhere to @nuxt/eslint-config v1

🏑 Chore

  • general
  • #6065 Fix typo
  • #5990 Inverse wording of error message
  • #5910 Update opencollective infos
  • #5869 Rename backers -> nuxters
  • babel-preset-app
  • #5897 Fix typo in babel-preset readme

βš“ Dependency Upgrades

πŸ’– Thanks to

  • 719media (@719media)
  • Anthony Fu (@antfu)
  • Farzad Soltani (@farzadso)
  • FranΓ§ois Hodierne (@znarf)
  • Josh Deltener (@hecktarzuli)
  • RafaΕ‚ ChΕ‚odnicki (@rchl)
  • Ricardo Gobbo de Souza (@ricardogobbosouza)
  • Ustun Ozgur (@ustun)
  • William Chong (@williamchong007)
  • bluelovers (@bluelovers)
  • orblazer (@orblazer)
  • yutanoma (@yutanoma)
  • Dzmitry Bachko (@dbachko)
Released 8 months ago

πŸ› Bug Fixes

  • vue-renderer
  • #5867 Fix exception on property access of undefined object
  • #5863 Prevent "can't set headers after they are sent" error in modern server mode
  • vue-app
  • #5864 Reduce consola direct access and don't override browser console.log
  • cli
  • #5865 Don't mutate options export to prevent ESM regression with nuxt.config in mixed (cjs + esm) mode (TIP: never mix them as is non-standard and may be unsupported in any future version)

πŸ’… Refactors

  • general
  • #5854 Prepare for external typescript support

πŸ’– Thanks to

  • RafaΕ‚ ChΕ‚odnicki (@rchl)
Released 9 months ago

😎 Developer Experience

  • #5770 Add a group for SSR logs to avoid polluting the browser console
  • #5810 Fancier browser logs with consola


  • #5820, #5832, #5834 Show build indicator in the browser when rebuilding code:


  • #5753 Watch for pages/ creation when default page displayed
  • #5812 Only listen for file changes for supported extensions
  • #5753 Re-use the same port when randomly assigned when restarting in dev mode

πŸ› Bug Fixes

  • vue-renderer
  • #5807 Add User-Agent‍ to Vary header in modern server mode
  • #5764 Safe format SSR logs
  • server
  • #5793 Preserve random port when restarting
  • Return listener when calling listen
  • builder
  • #5753 Watch for pages/ creation when default page displayed
  • #2812 Only listen for file changes for supported extensions
  • generator
  • #5791 Minify spa fallback
  • types
  • #5785 Add type definition for functional babel.presets
  • vue-app
  • #5757 Reuse page component with watchQuery
  • #5746 Remove trailing slash in vue-router non-strict mode
  • #5752 Don't attach catch handler to already loaded component
  • #5824 fixPrepatch in-out transition fix (issue #5797)
  • utils
  • #5754 Handle serializeFunction edge case

πŸš€ Features

  • vue-renderer
  • #5745 Add render.injectScripts option
  • #5784 Support render.ssrLog for controlling SSR logs

πŸ’… Refactors

  • core
  • #5796 Use require.resolve instead of Module internals
  • builder
  • #5792 Pass nuxt options to template as nuxtOptions
  • vue-app
  • #5770 Add a group for SSR logs
  • #5826 simplify mount error log
  • general
  • #5748 Small readability improvements

πŸ“ Examples

  • auth-jwt
  • #5775 Use named store export to prevent warning
  • typescript
  • #5742 Add missing ts-node dependency

🏑 Chore

  • ci
  • #5802 Upload test report to CircleCI and Azure
  • Add flags for codecov
  • general
  • Remove unused dependency cross-env
  • Add
  • Improve links in readme

♻️ Tests

  • general
  • #5790 Add unit tests for core/resolver.js
  • #5782 Remove duplicate unit tests in packages/core/test/resolver

βš“ Dependency upgrades

πŸ’– Thanks to

v2.7.1 (2.7.1)
Released 9 months ago


  • builder: use warn only for mismatched dependencies (#5723)
  • webpack: correctly resolve consola for the client bundle (#5729)

Dependency Upgrades

  • postcss-import-resolver: prefer style property when resolving (jsless/postcss-import-resolver#2)

Thanks to

  • Blake Kostner (@btkostner)
Released 9 months ago

DX Improvements πŸ’…

SSR logs in your browser πŸ–₯️

We all know the console.log debugging method, but when working with universal applications, you have to remember that sometimes, your logs are in your terminal and not in your browser console.

This can be really annoying when developing a Nuxt.js application, starting with this version and running nuxt dev, the ssr logs are now reported to your browser console:


Detecting store/ creation πŸ‘€

Nuxt.js now detects when you created a store/ directory and will reload himself auto-magically so you don't have to restart it anymore.


PS: We also improved the serverMiddleware watch to restart Nuxt.js and clean their cache

Fixes βœ”οΈ

  • builder: corretly detect mode of hashed plugins (#5695)
  • builder: call watch:restart after watch:fileChanged hook (#5620)
  • utils: node v8 not support dotAll in regex (#5608)
  • vue-app: properly catch component loading error (#5687) (#5688) (#5690)
  • vue-app: consider watchQuery option in routerViewKey (#5516)
  • vue-renderer: await on spa:templateParams hook (#5619)
  • webpack: set log level to warn for HardSourcePlugin (#5653)
  • vue-app: properly catch loading error in component prefetching (#5688) (#5690)
  • vue-app: avoid using aliases in templates (#5656)
  • builder: watch store dir and serverMiddleware paths (#5681)

Features πŸš€

  • vue-app: rename transition to pageTransition and deprecate it (#5558)
  • vue-renderer/vue-app: report SSR console logs to the browser with consola (#5673)
  • webpack: suppress not found typescript warnings (#5635)
  • webpack: extendable babel.presets and babel envName (#5637)
  • configurable aliases (#5655)

Refactors 🧹

  • server: exclude dist files request from browser detection (#5571)
  • vue-renderer: remove chalk in renderer (#5609)
  • vue-renderer: split renderer into ssr, spa and modern (#5559)
  • move modern detection from server to utils (#5584)

Examples πŸ“š

Typescript πŸ‘·

Only for typescript users, Nuxt.js v2.7 dropped support for node < 8.6 relate to ts-loader v6

  • add babel config types (#5666)
  • upgrade ts-loader to v6 (#5691)
  • fix type (#5701)
  • fix extendRoutes method type (#5700)
  • prevent ts-node to register twice (#5699)

Thanks to πŸ™

  • Christian Lehr (@clehr)
  • Hyunje Jun (@utatti)
  • RafaΕ‚ ChΕ‚odnicki (@rchl)
  • Yama-Tomo (@Yama-Tomo)
  • RenΓ© Stalder (@renestalder)
  • Kohei Ota (@inductor)
Released 10 months ago


  • cli: Watch and reload nuxt.config (#5574)
  • utils: serialize inline functions (#5051) (#5580)
  • vue-app: Fix context req and res types (#5560)
  • webpack: Fix production font preloading (#5436)
  • Don't customize esm options (91c3642e64166a939683b856e5b34ef42d12bb0e)

Dependency Upgrades

  • Update webpackbar to ^3.2.0
  • Update vue-router to ^3.0.6
  • Update @nuxt/loading-screen to ^0.5.0
Released 10 months ago


  • cli: Apply nuxt.config.js changes and watch for all imported files (#5500)
  • cli: Fix problem for users that have tsconfig.json but do not use typescript (#5478)
  • cli: Show memory usage after build for nuxt dev (#5514)
  • server Fix bug with SPA mode with CSP enabled (#5474)
  • vue-renderer: Use modulepreload for modern mode when using spa generate (#5489)
  • webpack: Suggest using official @nuxtjs/style-resources package (#5499)
  • Custom router.base support for banner url and loading screen (#5470) (nuxt/loading-screen#8)

Security Fixes

  • Prevent potential XSS vulnerabiliy when using vuex-router-sync (nuxt/devalue#8) (vuejs/vuex-router-sync#89)

Thanks to our awesome contributors to this release

  • Damian Stasik (@visualfanatic)
  • Andreas Zoellner (@zoellner)
Released 10 months ago

Migration Guide

This version is addressing most of the problems of 2.5 and is without any breaking changes. For most of the users, a normal version upgrade would be enough. However, reading this guide can help to have a smooth upgrade.

General Tips

  • Using yarn as the package manager is more preferred as Nuxt is internally being tested against yarn
  • Before upgrade ensure to remove yarn.lock, package-lock.json and node_modules
  • After full install and testing, also consider upgrading other dependencies. The yarn outdated command can be used.

Missing App Dependencies

Because of how package managers (yarn, npm) work, a wrong version of a dependency from one of the other dependencies may be hoisted into node_modules. Nuxt is strict about this and provides instructions for dependency resolution so please follow it.

The well-known problem is with firebase package that requires to manually install node-fetch dependency in your project.


Since [email protected] and [email protected] are both supported from babel 7.4.0, Starting from 2.6 Nuxt supports both versions (#5411). It is highly advised to stick with 2 (default) unless having a special dependency that needs 3. (Instructions for [email protected] are not required but recommended)

[email protected]

[email protected]

Edit nuxt.config.js:

export default {
  build: {
    babel: {
      presets({ isServer }) {
        return [
            // require.resolve('@nuxt/babel-preset-app-edge'), // For nuxt-edge users
              targets: isServer ? { node: '10' } : { ie: '11' },
              corejs: { version: 3 }


Nuxt 2.5 users may only require to add ts-node to the dependencies

Beta Testers : Replace nuxt by nuxt-edge, and @nuxt/typescript by @nuxt/typescript-edge in the following instructions.

  1. Remove nuxt-ts dependency (2.4 users only)
    • yarn: yarn remove nuxt-ts
    • npm: npm remove nuxt-ts
  2. Add nuxt and ts-node to dependencies:
    • yarn: yarn add nuxt ts-node
    • npm: npm i nuxt ts-node
  3. Add @nuxt/typescript to devDependencies:
    • yarn: yarn add -D @nuxt/typescript
    • npm: npm i -D @nuxt/typescript
  4. Create an empty tsconfig.json file. Nuxt will automatically generate it with defaults at first run, then you can edit it to fit your needs


  • feat(babel-preset-app): support specifying core-js version (#5411) (Xin Du (Clark)) (159123fe)
  • feat(cli): add internal _generate and _build options (#5434) (Pooya Parsa) (516aea3d)
  • feat(cli): add --quiet option to nuxt generate command (#5357) (Franck Abgrall) (91f4eb04)
  • feat(typescript): detect typescript based on tsconfig.json (#5412) (Pooya Parsa) (6ffc5c57)
  • feat(vue-renderer): add csp meta tags (#5354) (James George) (b978a376)


  • fix: unexpected token export in importing babel runtime helper (#5401) (ryota yamamoto) (3b85dd97)
  • fix(core): call ready to prevent breaking changes (Pooya Parsa) (#5413) (001ba775)
  • fix(build): disable loading babel.config.js by default (#5365) (Xin Du (Clark)) (64fa4244)
  • fix(builder): await for renderer to load resources (#5341) (Pooya Parsa) (caf51984)
  • fix(cli): catch all possible errors thrown from proper-filelock (#5347) (Pim) (39bbe46e)
  • fix(renderer): retry render if renderer is in loading or created state (#5417) (Pooya Parsa) (8b996959)
  • fix(vue-app): decode uri in getlocation (#5337) (Johan Roxendal) (77dcfe6e)
  • fix(vue-app): prevent mounting page twice on redirect (#5361) (noe132) (2d73e8ae)
  • fix(vue-renderer): add the csp hash if unsafe-inline hasn't been specified (#5387) (Sam Bowler) (97db6a4b)
  • fix(types): add type definition for typescript.typeCheck (#5326) (Daniel Roe) (2c1444d9)


  • refactor(typescript): only generate tsconfig.json if missing (#5356) (#5367) (Kevin Marrec) (9a3fc8a4)
  • refactor(vue-renderer): improve ready status error (#5339) (Pooya Parsa) (535327c4)
  • refactor(webpack): add ability to get webpack config class (#5378) (Damian Stasik) (abf7db1f)


  • examples: add docker example (#5430) (Utkarsh Gupta) (3eec1152)
  • examples(vue-apollo): update to @nuxtjs/apollo 4.x (#5345) (Dmitry Molotkov) (95f2a125)
  • examples(with-buefy): update example (#5348) (Dmitry Molotkov) (ce66a8cb)
  • examples(with-element-ui): fix package scripts (#5349) (Dmitry Molotkov) (10812e30)


  • chore(postcss): deprecate config support (#5419) (Alexander Lichter) (1bd4fb14)
  • chore(readme): fix grammar (#5395) (Irvin Lin) (f8d3626c)

Dependency Upgrades

  • loading-screen: use wss for https (nuxt/loading-screen#4)
  • loading-screen: fallback to fetch if ws fails (nuxt/loading-screen#6)
  • node-proper-lockfile: - fix mtime precision on some filesystems (#&#8203;88) (f266158), closes #&#8203;82 #&#8203;87
Released a year ago

Bug Fixes

  • fix: revert to [email protected] (#5317) (Pooya Parsa) (20836d93)
  • fix: remove consola.debug for hooks (#5318) (Thomas Reichling) (9ff01f9b)
  • fix: apply default lock options before setting lock (#5320) (Pim) (7c24280a)
  • fix(ts): wrong export used in render.d.ts (#5309) (Romain Lanz) (e67b2982)
  • examples: upgrade and fix typescript configuration files (#5310) (Romain Lanz) (7100a2c6)
  • chore: unsupport nuxt-legacy (pooya parsa) (797a4ce6)
Released a year ago

What's new?

15,000 line changes with 230 squashed commits by more than 30 contributors made this version possible! ❀️

Typescript DX

No longer needed to install nuxt-ts for typescript support. Nuxt.js officially supports TS by installing @nuxt/typescript. Please see #5079 for reasons behind such migration.


Babel 7.4, Core-js v3, and Object.assign polyfill for better browser support.


More than 30 fixes, refactors and performance improvements.

Open in Browser

Use nuxt dev -o to instantly open project in the browser and enjoy a cool loading screen:


[IMPORTANT] Migration Guide

Programmatic API / Middleware

If not already done, please explicitly call nuxt.ready() after new Nuxt(). nuxt.ready() was always async, but not awaiting the function call has now a severe impact.

   const nuxt = new Nuxt(config)
++ await nuxt.ready()


  1. Please replace nuxt-ts dependency and use nuxt + @nuxt/typescript. (Also nuxt-ts-edge to nuxt-edge + @nuxt/typescript-edge for edge users)
--  "nuxt-ts": "^2.4.2"
++  "@nuxt/typescript": "^2.5.0"
++  "nuxt": "^2.5.0"
  1. Configuration API to customize/disable type checking has been moved from build.useForkTsChecker to build.typescript.typeCheck. Please see #5079 for more details.
build: {
-- useForkTsChecker: false // or ForkTsChecker options
++ typescript : {
++   typeCheck: false // or ForkTsChecker options
++ }


  • feat(babel): include es6.object.assign by default (Clark Du) (52fe145a)
  • feat(cli): lock project during build or generate (#4985) (Pim) (4e51723e)
  • feat(cli): option to open the project in the browser (#4930) (Ricardo Gobbo de Souza) (4c7bd9c5)
  • feat(generate): return non-zero code or page error (fixes #4991) (#5195) (Jarek Lipski) (c6565c97)
  • feat(module): support src as a function in addModule (#4956) (Ricardo Gobbo de Souza) (1e9eb4b7)
  • feat: support .nuxtignore (#4647) (Xin Du (Clark)) (59be77a2)
  • feat: support devModules option (#5102) (Jonas Galvez) (e87711c5)
  • feat(ts): nuxt configuration typedefs (#4854) (Kevin Marrec) (92f81e01)
  • feat(vue-app): universal fetch (#5028) (Pooya Parsa) (2015140d)
  • feat(vue-renderer): improvements (#4722) (Pooya Parsa) (29297160)
  • feat(vue-renderer): use async fs (#5186) (Pooya Parsa) (d07aefa5)
  • feat(ts): better DX for typescript support (#5079) (Kevin Marrec) (920f444b)
  • feat: loading screen (#5251) (SΓ©bastien Chopin, Pooya Parsa) (ef41e205)
  • feat: support core-js 3 (#5291) (Xin Du (Clark)) (d094c4a9)


  • fix(builder, vue-app): order of plugin execution based on order in array (#5163) (Dmitry Molotkov) (a867dbd3)
  • fix: correct public path in generation and start (#5202) (Xin Du (Clark)) (648062c3)
  • fix: default for-exit to false to prevent dev exit (pooya parsa) (a347ef9b)
  • fix: disable "analyze" for nuxt generate (#4975) (Alexander Lichter) (574a2eb2)
  • fix: disable parallel build when extractCSS is enabled (Clark Du) (aad46ed6)
  • fix: extra properties in templateFiles (#4925) (Xin Du (Clark)) (ca191240)
  • fix: fix non standard esm modifications (pooya parsa) (fb87a559)
  • fix: generate failure (#5007) (Andrey Shertsinger) (bcd672f9)
  • fix: keep-alive component data should not be updated (#5188) (Xin Du (Clark)) (1ea86617)
  • fix: not send Server-Timing header if no timing info (Clark Du) (d9a0b5f6)
  • fix(postcss): default to preset-env and cssnano last (#5215) (Alexander Lichter) (adf423a5)
  • fix: publicPath is not reactive in dev restarting (#5227) (Xin Du (Clark)) (1fb7538d)
  • fix: refactor file watchers (chokidar/linux workaround) (#4950) (Pim) (5ec5932b)
  • fix: remove cache-loader for external resources (#4915) (Xin Du (Clark)) (0223e56d)
  • fix: respect namespaced in store module (#5189) (Xin Du (Clark)) (9e1ef888)
  • fix: revert templatFiles name (#4924) (Xin Du (Clark)) (f70645e5)
  • fix: trailing comma in tsconfig (#5061) (Sergey Vikulov) (1fb44d94)
  • fix(ts): deprecate isClient, isServer, isStatic (#5211) (Daniel Hritzkiv) (29c3c425)
  • fix(types): reflect chainlable NuxtLoading methods (#5104) (MatjaΕΎ LipuΕ‘) (66273f4b)
  • fix: Unexpected token …. Expected a property name in Safari (Clark Du) (eef7f695)
  • fix(vua-app): clone mount error to prevent mutating read-only error object (#5214) (Alexander Lichter) (37006f62)
  • fix(vue-app): avoid css chunk error (#5173) (Yutaka Sasaki) (41028a40)
  • fix(webpack): clone config.entry (fixes #4849) (#5236) (Julien Dargelos) (82167651)
  • fix: disable extract-css-chunks-webpack-plugin in dev mode (#4888) (Xin Du (Clark)) (928a230f)
  • fix(server): handle decodeURI error (#5243) (phof) (5b7f6d78)
  • fix: correct socket address in use error message (Clark Du) (2eb19653)
  • fix(utils): relax lock settings (#5280) (Pim) (65a431d6)
  • fix(vue-app): multiple named views cause invalid syntax (#5262) (Michael Leaney) (d03a61b0)
  • fix(webpack): loaders in extend config is broken (#5292) (Xin Du (Clark)) (0eb5ed97)
  • fix(vue-app): duplicated router.base when using context.redirect(object) (#5290) (Nianyong) (cf02e822)
  • fix(vue-app): decode router base to support unicode characters (#5297) (Alexander Lichter) (3ac01df4)

Performance Improvements

  • perf: await routeData promises in parallel (#5027) (Alexander Lichter) (0826d7e5)
  • perf(core): skip esm for node_modules and non .js files (#5220) (Pooya Parsa) (aabb1f69)
  • perf(webpack): use futureEmitAssets (#5003) (Alexander Lichter) (3997d504)
  • perf(ts): transpileOnly when using nuxt-ts start (#4906) (Kevin Marrec) (17cc12f0)


  • examples(jest-puppeteer): fix package .json (#4997) (Andrew Cravenho) (dfc8dd57)
  • examples: improve vuex store example (#5017) (Alexander Lichter) (a9511e58)
  • examples(pug): fix example by adding plain-pug-loader (#5223) (Paul Geisler) (320a46fe)
  • examples(vuex-store): change to module store (#4923) (Alexander Lichter) (be41ae1c)
  • examples: add pug-stylus-coffee (#4927) (chiboreache) (6d059698)
  • examples: add tsx example (#4855) (andoshin11) (5101dc6a)
  • examples: fix jest test dependencies (#5155) (Dmitry Molotkov) (1c3761a6)
  • examples: fix links to vue-meta repo (#5018) (Pim) (06f4762e)
  • examples: rebase on latest stable nuxt version (#4874) (Alexander Lichter) (47898fbd)
  • examples: zero-downtime pm2 typescript example (#4907) (Dmytro) (1fb9af33)
  • examples: fix dynamic components example (#5294) (Dmitry Molotkov) (d9db45c2)


  • refactor: generate routes and template files in builder (#4883) (Xin Du (Clark)) (4c5a59e1)
  • refactor: improve modern middleware and spa modern rendering (#5037) (Xin Du (Clark)) (05299d67)
  • refactor: isModernBrowser return boolean for avoiding duplicate call (Clark Du) (c6d8e8ff)
  • refactor: not detect modern browser if modern mode is disabled (Clark Du) (2b4d79c1)
  • refactor: remove builder coupling from server (#5157) (Pooya Parsa) (13cb0f73)
  • refactor: remove unnecessary onEmit in old webpack (Clark Du) (eac6d022)
  • refactor: some small stuff (#4979) (Alexander Lichter) (69dfd848)
  • refactor: fix typos (#4922) (Alexander Lichter) (569b6aab)
  • refactor: unify context in webpack module (#5054) (Xin Du (Clark)) (9860eb6a)
  • refactor: use spread syntax for plugin push (#4976) (Alexander Lichter) (31cb1873)
  • refactor: fallback to babel-preset-env defualt targets when buildTarget is not specified (Clark Du) (176641f6)
  • refactor(ts): add warning for nuxt-ts deprecation (#5301) (Kevin Marrec) (a11afd45)


  • chore(babel-preset): create readme with basic docs (#5127) (HG) (04cdd602)
  • chore: don`t ignore .nuxtignore (#5169) (Dmitry Molotkov) (39c9ab59)
  • chore: enable yarn.lock maintenance (#5063) (Xin Du (Clark)) (17b53ebf)
  • chore(vue-app): suppress deprecated warning for classic vuex in prod (#5137) (Shingo Sato) (f39205a7)


  • test: add await for promisable expect (Clark Du) (fabf1c07)
  • test: add chrome detector (#4984) (Xin Du (Clark)) (855705bd)
  • test: add describe.posix and win (Clark Du) (e9ba2f97)
  • test: fix macos e2e tests (Pooya Parsa) (2c763df1)
  • test: improve nuxt-loading component tests (#5005) (Pim) (75a74543)
  • test: mock enquirer in typescript tests (#5025) (Pim) (ad6a8cda)
  • test: skip reqest in dev test for now (Clark Du) (3e678793)
  • test: try to fix unhandled request (Clark Du) (2f2baacb)
  • test: turn off cli dev test (Clark Du) (5c053f5c)
  • test: unit tests for generator (#4857) (Xin Du (Clark)) (e22a282e)
  • test: unit tests for @nuxt/util (#4880) (Xin Du (Clark)) (96bab9f0)
  • test: unit tests for server module (#5154) (Xin Du (Clark)) (cc573a49)
  • test: update cli snapshot (Clark Du) (3dd1a285)
  • test: unhandled open handles (Clark Du) (858c9eeb)
  • test: change cli.test to be more accurate (#4957) (Xin Du (Clark)) (68f6880f)
  • test: use puppeteer-core (#4929) (Pooya Parsa) (940a36fd)
  • test: fix e2e test by downloading chromium (#5254) (Pooya Parsa) (2561b68a)
  • test: fail tests in case of unhandled errors (#5255) (Pooya Parsa) (d6b505aa)
Released a year ago

v2.4.5 (2019-02-26)

Bug fixes and Improvements

  • builder: bundle resources other than js(x)/json in node_modules (#4913) (71a70fe)
  • cli: dont force exit when it was explicitly disabled (#4973) (4b82aa9)
  • cli: show warning on forced exit (#4958) (3d2deac)
  • dependencies: update serve-placeholder and esm (#4970) (111455f)
  • vue-renderer: preload modern resource in spa modern mode (#5043) (3516580)
  • vue-app: fix asyncData memory leak on client-side (#4966) (4086800)
  • vue-app: fix getNuxtChildComponents method (#4969) (dbf7099)
  • vue-app: use browser to handle scrolling position on page reload… (#5080) (7001312)
  • webpack: bundle resources other than js(x)/json in node_modules (#4913) (71a70fe)
  • nuxt-ts: error catch in nuxt-ts binary (#5086) (4f887f6)
Released a year ago

πŸ› Bugfixes

  • webpack: Update dependency terser-webpack-plugin to ^1.2.2.
  • webpack: Update dependency webpack to ^4.29.2
  • utils: Fix serializeFunction for external imports (#4916)
  • config: Warn when using array for postcss config (#4936)
  • module: support src as a function in addModule (#4956)
  • server: await buildDone hook (#4955)
Released a year ago


  • Handle async components correctly when using nuxt-ts (PR #4886)
  • Fix extractCSS in dev mode (PR #4888)
  • Correctly apply class when using linkPrefetchedClass (PR #4893)
Released a year ago

Upgrade Note ⚠️

Due to a known problem (webpack/webpack#8656, #4869, #4839) users of npm should either remove package-lock.json and reinstall before upgrade or use npm update acorn --depth 20 && npm dedupe after upgrading to 2.4.0. yarn users should have no problems and safe! but removing yarn.lock still recommended before the upgrade process.

Important news πŸ‘€

New core team member 🐀

We are really proud to announce Kevin Marrec (@kevinmarrec) as a new core team member of Nuxt.js. He is French πŸ‡«πŸ‡· and responsible for the TypeScript integration πŸ’š

Official Consulting β›‘

We now offer official support & consulting from the core team. We partnered with Otechie for the process and already did some beta-tests with selected companies.

Are you interested or curious?
Learn more on πŸ™Œ

RFC Process πŸ“Ž

We invite you to take a look at our nuxt/rfcs repository where we discuss the future of Nuxt and its vision.

Here are some interesting proposals if you want to learn more about the upcoming changes of Nuxt:

  • Full static generated mode to generate offline-ready static websites with Nuxt by default
  • Fabula, a Vue/Nuxt-inspired tool for running tasks on local and remote hosts
  • Improve @nuxt/config package to support a config/ directory and autocomplete
  • Nuxt Workers to open more possibilities on the server part (clustering, PM2 integration, HMR on the server and more)
  • Module improvements to give more power to Nuxt modules
  • And many more πŸ’š

Release Plan 🚒

Starting with this release, Nuxt will adhere to a formalized release plan (as good as possible). Also, an end of life for older major versions is defined within

Quick summary:

  • Nuxt major releases are planned every 6 months.
  • The release cycle for Nuxt.js minor versions is roughly 4 weeks.
  • Fixes will be released as soon as possible after the actual PR/commit

We strongly invite you to read the for further details.

Thank you ❀️

We want to specially thanks:

  • Our contributors submitting bug reports, feature requests and commenting on issues
  • Our users participating on our Discord server and sharing the love by mentioning our Twitter account
  • All the devs working for companies using Nuxt.js and who helped us building a showcases list
  • Our backers and sponsors supporting us financially through our open Collective

New Features ✨

Speaking of TypeScript…

TypeScript support has landed!


In order to run Nuxt with TypeScript, we created a new distribution, called nuxt-ts (we also have nuxt-ts-edge).
We want to thank @hmsk for his donation of the package name on npm ❀️

You can explore Nuxt TypeScript example or play with it directly in our Nuxt TS CodeSandBox.

For a more advanced example, you can look at the HackerNews-TS repo or play with it on CodeSandBox, made by @husayt & @kevinmarrec.

This work has been made by @kevinmarrec with the help of @pi0 & @Atinux.

⚠️ Experimental: We are waiting for your feedback to keep improving it and breaking changes can occur without a semver major release. However, all changes will be documented properly

Smart prefetching ⚑️

Nuxt.js will automagically prefetch the code-splitted pages linked with <nuxt-link> when visible in the viewport by default. This hugely improves the end user performances, inspired by quicklink.


Demos are online and we recommend you to try it out to feel the difference:

Bonus: we added $nuxt.isOnline and $nuxt.isOffline which is reactive, so you can use it directly inside your components (see this example).

You can learn more about this feature in the associated PR #4574 and in the documentation.

HMR & best practices for store/ πŸ‘€

Save more development time with full HMR support for the store (mutations, getters, and actions).


This feature has been implemented by @manniL & @Atinux on PRs #4589, #4582 and #4791

Autocomplete for VS Code (via. Vetur extension) βœ…

If you are using VS Code, with this version, you will now have autocomplete for Nuxt.js components:


This feature has been implemented by @octref & @Atinux on PR #4524

Port taken? Nuxt got your back! πŸ’ͺ

If Nuxt wants to listen on a port which is already used, it will warn you in development and listen to a free port instead:


In production it will throw an error instead to avoid unwanted behavior:


This feature has been implemented by @ricardogobbosouza on PR #4428 with the help of @pi0 and @manniL.

Suggest installing missing dependencies or mismatches πŸ’―

Nuxt requires all peer like dependencies as a dependency for easier usage. Sometimes this causes unwanted behaviors when users explicitly add a specific version in their package.json which is incompatible with nuxt. This could also help to resolve popular Vue packages version mismatch error (#198, #669, #1084, #1414, #1851, #2079, #2406, #3454).

Nuxt is now able to automatically self-verify installed dependencies and warn with a proper message in case of detecting problems.


This feature has been implemented by @pi0 in PR #4669

Auto-detection of modern bundles πŸ₯‡

When running nuxt start, Nuxt will automatically detect if you built your app modern mode enabled. No need to run nuxt start --modernexplicitly anymore 🌟

screenshot 2018-11-30 at 16 55 48

This detection was created by @clarkdo on PR #4422

Plugin modes and file extensions πŸ’…

Until now, you used ssr: false in your plugin declarations to disable server-side rendering. We decided to deprecate that option and introduce a mode instead, which can be 'all', 'client' or 'server'. No worries, ssr is still working (until Nuxt 3).

The new feature coming with the mode is that you can define it by using the file suffix:

  • plugins/plugin.server.js
  • plugins/plugin.client.js
  • plugins/plugin.js

By adding the plugins to your nuxt.config.js:

plugins: [

The declaration will be internally transformed to:

plugins: [
  { mode: 'server', src: '~/plugins/plugin.server.js' },
  { mode: 'client', src: '~/plugins/plugin.client.js' },
  { mode: 'all', src: '~/plugins/plugin.js' }

(If you specify the mode manually, it will overwrite the suffix detection)

This feature has been implemented by @clarkdo on PR #4592

Module commands πŸ–₯

Nuxt modules can now include bin scripts that are recognized by Nuxt's CLI.

Here's an example of my-module/bin/command.js:

#!/usr/bin/env node

const consola = require('consola')
const { NuxtCommand } = require('@nuxt/cli'){
  name: 'command',
  description: 'My Module Command',
  usage: 'command <foobar>',
  options: {
    foobar: {
      alias: 'fb',
      type: 'string',
      description: 'Simple test string'
  run(cmd) {

The command could be run with:

npx nuxt command arg1 arg2

You can learn more about that in the modules command documentation.

⚠️ Experimental: We are waiting for your feedback to keep improving it and breaking changes can occur without a semver major release. However, all changes will be documented properly <3

This feature has been implemented by @galvez on PR #4314 with the help of @pi0.

PostCSS in Vue Components πŸ’ƒ

You can now use lang="postcss" in your Vue components. Postcss has applied to all your styles anyway (e.g. to resolve aliases like ~) but the lang attribute enables autocomplete and syntax highlighting for some IDEs.


This feature has been implemented by @manniL on PR #4417.

No more extensions for Stylesheets needed πŸ¦…

stylesheet extensions

We are concerned to improve the Developer Experience ("DX") with each release. This small change allows you to omit the file extension for CSS/SCSS/Postcss/Less/Stylus/… files listed in the css array inside your nuxt.config.js. For the plugins or serverMiddleware key, this is already possible.

This feature has been implemented by @manniL on PR #4671.

SSR Bundle improvements πŸ”Ή

We made a full rewrite of how SSR bundle is packaged.

This means better performance, less memory overhead, fewer OOM crashes and easier SSR bundle debugging.

_ Before After Diff
Dist 8.2M 7.2M -1M / 12%
Dev 281 MB (RSS: 439 MB) 237 MB (RSS: 354 MB) -44M / 16% (RSS: -85M / 19%)
Start 106 MB (RSS: 169 MB) 71.7 MB (RSS: 137 MB) -34M / 32% (RSS: -32M / 19%)

This feature has been implemented by @pi0 on PR #4439.

Other changes πŸŒ”

  • process.modern can be used for distinguishing modern environment.
  • Add server.timing to give Server-Timing header, useful for monitoring and performances overview (PR #4800)
  • ⚠️ Experimental: Enable HardSourceWebpackPlugin by hardSource: true in hardSource of nuxt.config.js
  • You can now set scrollToTop to false in pages (PR #4564)
  • Aliases for nuxt-link and nuxt-child (n-link and n-child) are available now (PR #4525)
  • Components can now be used in PascalCase as recommended by the Vue styleguide (PR #4396)
  • VueMetas headAttrs are now supported for the appTemplate (PR #4536)
  • More browsers are added to the list of modern browsers (PR #4516, PR #4775)
  • Loaded resources can now have a crossorigin attribute (PR #4472)
  • Modern mode resources are preloaded and will be pushed via HTTP2 server push if set (PR #4508)
  • Add option to disable the compression middleware (PR #4381)
  • Add option to disable the FriendlyErrorsWebpackPlugin overlay (PR #4381)
  • Add exclude option to exclude pages from being generated (in static mode) but still get rendered via fallback/SPA (PR #4754)
  • Support build.hotMiddleware.client (PR #4796)
  • New examples have been added:
  • styled-vue (PR #4712)
  • pug (PR #4409)
  • Internal changes:
  • feat: use runInNewContext: true for nuxt dev (#4508)
  • feat: check modern build file in modern mode (#4467)
  • refactor: migrate to extract-css-chunks-webpack-plugin (#4495)

Further Patches (30+) πŸ”

122 releases found.