Breaking Changes

The 0.9.0 is an important release, we can now define dynamic routes without the nuxt.config.js file, please read more in examples/custom-routes/

The router.routes object does not exist anymore, this gives a better readability for any Nuxt.js project without removing any features.

We also introduce a validate({ params, query }) method to validate the routes params/query before entering the the data method, if you return false, the error page will be displayed with a 404.

Also, we can now define children routes by creating a directory with the same name as the file, example:

-| pages/
---| parent/
-----| child.vue
---| parent.vue

And then, in your parent.vue component, you can add <nuxt-child></nuxt-child> to display the child component (when navigating to /parent/child)

Features

• JavaScripts hooks can be defined in the transition property. To see the list of props and events: https://vuejs.org/v2/api/#transition
  transition can also be a function (to, from) { return 'fade' } so you can set a different transition depending of the route destination
• Introduction <nuxt-link> which is exactly the same as <router-link> but in the future, will add lazy-loading and more 🔥

If you were using the class .router-link-active, please replace it to .nuxt-link-active, or if you want to keep the router-link-active class, update your nuxt.config.js like this:

module.exports = {
  router: {
    linkActiveClass: 'router-link-active'
  }
}

Improvements

• You can import components without giving the .vue extension now (fixed #59)
• In development mode, when the nuxt.config.js file changed with a syntax error, the server will not crash (fixed #60)
• Upgrade to webpack 2.2.0-rc.0
• build.babel options are given to the vue-loader as well. Now you can write JSX in your vue components, see https://gomix.com/#!/project/nuxt-hello-world-jsx

Bug fixes

• Fix importing .js file with ES6 syntax in .vue files (Fix #63)
• Use cross-env for setting NODE_ENV=production on Windows (#65)
• Avoid the renderer error when nuxt.config.js change on nuxt (#66)

What's next?

Before launching the 1.0.0, we are working on:

• 100% coverage with a lot of tests because it's really important for us to deliver a reliable framework
• The ability to add middleware to your routes, useful for having routes that need the user to be authenticated first
• config.build.publicPath, see #25
• nuxt.renderStream and nuxt.renderRouteStream, see #26
• Generate filenames with chunkName for avoid CDN caching
• A complete documentation on nuxtjs.org
• Real-life examples
• Improvements and bug fixes

Improvements

• Nuxt.js is now compatible with node 4 and higher (Using babel and webpack)
• Add test and coverage (ava, jsdom and nyc)

Bug fixes

• Fix error.vue layout path with srcDir (#54)

Fix

• Push the srcDir feature to npm (fix #53)

Features

• Add srcDir option allowing you to have your pages directory and other source folder for Nuxt.js in a sub directory, see #44 for more details (credits to @cj)

Improvements

• Optimise generate() when generating +100,000 paths, calling them 500 by 500 to avoid out of memory

Bug fixes

• Fix layouts/error.vue which was not assigned to the right variable when existing

Bug fix

• Set window.onNuxtReady before importing the plugins so we can use this hook inside them

Feature

• Add routeChanged event for $nuxt, you can use it like this in your plugins:

if (process.BROWSER_BUILD) {
  // set google-analytics script here...
  // and then:
  window.onNuxtReady((app) => {
    app.$nuxt.$on('routeChanged', (to, from) => {
      ga('set', 'page', to.fullPath)
      ga('send', 'pageview')
    })
  })
}

Breaking Changes

• The layouts has been moved to the layouts/ directory for better architecting. Which have to move your pages/_app.vue to layouts/app.vueand pages/_error.vue to layouts/error.vue
• When used programmatically, you now have to call nuxt.build() because new Nuxt(options) is not launching anymore the build automatically.

const Nuxt = require('Nuxt')
const nuxt = new Nuxt(options)
nuxt.build()
.then(() => {
  app.use(nuxt.render)
})

Features

• Add nuxt.renderAndGetWindow(jsdom, url) method to render the url and sent back the window object, useful for test purposes (see examples/with-ava/)

Examples

• Add authenticated routes example: https://nuxtjs.org/examples/auth-routes

Features

• Add env in the data context argument
• Add $nuxt.error({ statusCode, message }) method in the client side for calling the error page

Improvements

• Add generated name in the routes generates by the pages directory (ex pages/index.vue will me the index name, pages/foo/bar.vue will be foo-bar)

Fix

• Fix router.base when set to '/' or undefined, avoid generating 2 //

Misc

• Start working on the examples/auth-routes/ example

Improvements

• Update vue-router to v2.1.0
• Add examples/cached-components/ example

Improvements

• We don't need to bind nuxt.render.bind(nuxt) anymore to use nuxt.render as a middleware (Issue #18)

Bug fixes

• Make sure to generate the .nojekyll file empty

Features

• nuxt generate now adds a .nojekyll file in the generated folder to tell Github Pages to not ignore the _nuxt directory (see github pages docs about it)

Updates

• nuxt init has been remove, use nuxt/starter instead

Breaking Changes

• pages/_error-debug.vue has been removed, now only pages/_error.vue should be defined

Improvements

• Add Content-Length header in the server when rendering the html

Features

• You can now access the application path with ˜, useful if you have others folders, see #16
• Add env property in nuxt.config.js, you can now define environment variables that will be shared across the components (client and server side), see #16
• window.onNuxtReady(callback) is now a function, useful for attaching multiple functions to it, when is the app will be mounted, the callback will be called with the root application in the first argument

window.onNuxtReady(function (app) {
  // app is the $root vm
})

It is useful for test purposes or when defining plugins to launch when the app is mounted.

Bug fixes

• Use babel preset 2015 by default in .vue files to have the best compatibility possible in the browsers

Improvements

• Remove vue-loaders js and css settings (let vue-loader handle it)
• Call the store.replaceState once the app is instantiated

Breaking Changes

• If you were using process.BROWSER to add special code for the client bundle, please use process.BROWSER_BUILD now. Also, process.SERVER_BUILD has been added too.

Features

• Add alias ~router to import the vue-router router created by nuxt.js (can be useful to use vuex-router-sync for example.

Improvements

• Custom routes path with regexp are now working

Dependencies

• Upgrade vue to 2.1.2
• Upgrade vue-meta to 0.5.2
• Remove glob-promise and only use glob instead

PS: working also on nuxt generate, to generate modern static websites with html files generated => Nuxt.js apps could be hosted on Github Pages 🔥

Update outdated dependencies

• glob-promise to v2.0.0
• css-loader to v0.26.0

Check Nuxt.js dependencies on https://david-dm.org/nuxt/nuxt.js