🐛 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

🐛 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)

🐞 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)

🌟 Highlights

• 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 sass-loader@8
  • #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

• Louis-Marie Michelin (@lmichelin)
• Daniel Roe (@danielroe)
• Snir Shechter (@SnirShechter)
• @radimhornicek
• @xxRockOnxx

🐛 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

• core
  • #6271 Use hable

🐛 Bug Fixes

• vue-app
  • #6252 Provide typescript backward compatibility
• loading-screen
  • nuxt/loading-screen#38 set Content-Type for index page

📝 Examples

• CoffeeScript
  • #6248 Update module for using additionalExtensions

💖 Thanks to

• Artyom Bogomolov (@DevArtyom)
• Rafał Chłodnicki (@rchl)

🐛 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

• typescript
  • #5854 Prepare for external typescript support

💖 Thanks to

• Rafał Chłodnicki (@rchl)

😎 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
  • Enable audit
• general
  • Remove unused dependency cross-env
  • Add FUNDING.md
  • 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

• consola v2.7.0
• connect v3.7.0
• webpack v4.32
• babel v7.4.5
• thread-loader v2.1.2

💖 Thanks to

• @aaronransley
• @alexandreDavid
• @Elevista
• @utatti
• @rchl
• @maunier
• @cuixiaorui
• @Globegitter

Fixes

• 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)

Fixes

• 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)

Fixes

• 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 (91c3642)

Dependency Upgrades

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

Fixes

• 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)
• Vasyl Boroviak (@koresar)

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.

Core-js

Since core-js@2 and core-js@3 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 core-js@2 are not required but recommended)

core-js@2

• yarn: yarn add -D core-js@2 @babel/runtime-corejs2
• npm: npm i -D core-js@2 @babel/runtime-corejs2

core-js@3

• yarn: yarn add -D core-js@3 @babel/runtime-corejs3
• npm: npm i -D core-js@3 @babel/runtime-corejs3

Edit nuxt.config.js:

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

Typescript

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

Features

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

Fixes

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

Refactors

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

Examples

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

Chore

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

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 (#​88) (f266158)

Bug Fixes

• fix: revert to corejs@2 (#5317) (Pooya Parsa) (20836d9)
• fix: remove consola.debug for hooks (#5318) (Thomas Reichling) (9ff01f9)
• fix: apply default lock options before setting lock (#5320) (Pim) (7c24280)
• fix(ts): wrong export used in render.d.ts (#5309) (Romain Lanz) (e67b298)
• examples: upgrade and fix typescript configuration files (#5310) (Romain Lanz) (7100a2c)
• chore: unsupport nuxt-legacy (pooya parsa) (797a4ce)

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)

🐛 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)

Bugfixes

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

Thanks to @clarkdo and @ederchrono for this fix ❤️

🔧 Fixes

• fix(vue-router): router Expected "0" to be defined (22679cb) (#4394)

Fixes

• Use exact versions for Nuxt internal packages
• Fallback to default value when publicPath is falsy (#4365)
• Add lodash inside templating (#4368)

Patches

• Backport --no-generate option to nuxt build with SPA mode (PR #4127)

Fix

• Upgrade vue for fixing XSS vulnerability on SSR

Minor

• Feature: You can now customize the directories names (see PR #2748)
• Feature: add static.prefix (PR #2755)
• Feature: you can now add a layout with a module (see PR #2790)
• Hooks: add context as third parameter of render:route hook (PR #2754)
• Multiple policy support for Content-Security-Policy #2736
• Inject ssrContext into createRouter and createStore (see PR #2831)

Fixes

• fix: add the possibility to set staging environment via NODE_ENV (PR #2742)
• Fix: Changing only the query on a non-dynamic component was not updating page data (fix #2737)

Misc

• Refactor cli (PR #2783)

Thanks

Big thank you too all the contributors for these amazing pull requests 👏

Minor

• Add SPA fallback template, this is a killer feature for static generated websites, please read #2690
• Check expected node version #2718
• Support scrollBehaviour with transitions (fix #1376), big thank you to @homerjam for his help on this!

Fixes

• Support auto import of .jsx files (PR #2696)

Fixes

• fix: Add postcss-import-resolver in dependencies

Patches

• fix(module): default module options to empty object
• misc: use console.warn for warnings
• style: format with prettier
• fix: logError is not a function #2577.
• fix: exit with code (0) on successful nuxt-build #2569.
• fix: regression with module.addVendor with array #2574.
• test: add failing test for #2574

1.0.0 is out! 🎉

It's been a long run and we are really proud to announce the official 1.0 release. Thank you so much for your support and we are looking forward to hear your feedback ❤️

Medium article: https://medium.com/@nuxt_js/nuxt-js-1-0-is-out-bab1af459972

Breaking changes

⚠️ Minimum Node.js version required for Nuxt.js is also increased to 8.0.0 (Current LTS). This allows notable security and performance improvements for both Nuxt and SSR rendering by using native async/awaits and making development easier. So don't forget to upgrade Node to the latest version in both server and your local environment ;)

We have a new internal hook system now, some modules can be broken with 1.0 if they were relying on this.nuxt.plugin(), instead, they will have to use this.hook(), see module hooks documentation.

We removed the internal extensions for .ts, if you want to use TypeScript into Nuxt.js, we recommend you to check out our typescript example.

Deprecation

For the below depreciation, it will still work but you will get a warning to tell you to change your code to the new value.

For better bundling experience for server-side and client-side, we deprecated context.isClient and context.isServer in flavor of process.client and process.server. Since these variables comes from our webpack configuration, it will optimize your client-side and server-side bundles magically 💅

We also deprecated dev property inside build.extend() in flavour of isDev.

Features

• We are now ignoring files starting with a - in front of its filename (example: pages/-ignored.vue) (PR #2417)
• Layout transitions #1620
• Add route.meta (array of matched page .meta) into context, useful for middleware (see details)
• Middleware: you can now define middleware as a function, see example
• Store: you now have access to this.$router and this.app inside your store actions!
• You can set body: true, in your head.script[] to move your scripts at the end of <body> (see example)
• nuxt generate --no-build: Useful for conditions when just dynamic routes are being changed. This makes incremental builds much faster.
• Hooks: you can extend even further Nuxt by using hooks now, the documentation is coming soon.
• New configuration: build.styleResources, check out our style-resources example.

Improvements

• Upgrade Vue to 2.9.x #1723 #1868
• Upgrade to Vue-Router & Vuex to 3.0
• No more babel warning #1698
• Adds support for folders in /layouts #1865
• Mode spa: Respect mounted hook on first render (fix #1629)
• Add --version & -v flag to nuxt binary (you can do npx nuxt -v to know which version of nuxt.js you are using in your project) #1840
• Improve error message when a plugin is not found #1846
• Add ENV variable into app.html, corresponds to env from your nuxt.config.js
• Context is shared across plugins and pages (useful for axios interceptor with redirect), it also improves perfs!
• Improved plugins system
• Better nuxt dev experience with faster and more stable reloads
• SSR performance improvements thanks to node async/awaits
• Allow redirects to external URL (#2265)
• Support options.modulesDir as Array
• Upgraded uglifyjs with parrallel options as default for faster builds

Fixes

• Fix error handler if error message is readonly #1673
• Fix code typos #1613
• Update .gitignore #1860
• Generate: don't assume /index.html exists when copying to 200.html #1937
• head.titleTemplate with function is now working (fix #1886)
• Fix nuxt-start dependencies
• Fix Memory leak with inject: #1695 (comment)
• Fix unexpected state resetting on nested views (fix #1408 via #1914)
• Fix layouts in SPA mode (#1929)
• Fix video src in templates (fix #2008 via #2016)
• Improve Webpack rebuilding without reason (6dfe660)
• Update no-ssr to v0.2.1 #2181