Nuxt.js — gh-pages deployment

New technologies — new problems: I wasted several hours to publish my nuxt project on gh-pages and it was real pain. Now I want to explain, how to publish your static app in 5 minutes.

Create nuxt-app project for publishing.

Firstly, we need to create a simple nuxt-app project — for that, please open terminal and execute the following command:

After that you will be asked about properties of project: name, author, etc. I advise you to leave the values by default, simply pressing Enter on answers:

After finishing of installation, you can run locally app, using following commands:

And on localhost:3000 you see you nuxt-app:

More pages in app!

By default we have only one page in the site. Let me to create another one for making our example more representative. Open project folder (nuxt-gh-pages) and in folder pages create file about.vue with the following content:

Brief explanation: in Nuxt in folder pages contains files, which specify pages of your site. Every *.vue file is page(and available in site by the name of *.vue file). index.vue is the main page of your site. If you want to add page for your site, simply add *.vue file in your pages dir.

So, in our example we’ve created page About, which now is available, if you visit your http://localhost:3000/about :

Connection with the Github

Now it’s time to put our project on the Github for synchronisation. Open Github and create new repository, naming it nuxt-gh-pages — you see starting page of project:

Now in you terminal, being in project folder, interrupt process of running server, pressing CTRL+C, and type the following:

Well done! What’s next?

Reconfiguration of nuxt.config.js for gh-pages deploying

And now let’s open nuxt.config.js in our project and edit it for deploying.

First of all, in module.exports section change mode to ‘spa’ and add configuration for router:

‘spa’ means, that our app is simply static, in router section we specify the name of repository, which will be used for rendering site.

Next go in the terminal and run:

It will generate dist folder with all static information of our site:

Gh-pages package

For deploying on Github pages I usually use gh-pages package — it allows to push directory dist in gh-pages branch in your project. Please, execute the following in your project:

And in your package.json file in scripts section, add “deploy” script:

Finally, run in terminal:

Next open your project in Github and open Settings section. In Section “GitHub Pages” you see the message, that your site is published:

My site now is available by url: You can also see about page:

Problem? Do you see only white screen?

You’re trying to open your site and see only white screen? I know, in what can be problem. Please open your project in gh-pages branch and add manually empty .nojekyll file in project. Somehow it can be ignored while deploying site on gh-pages.

So, it works! Don’t hesitate to ask questions, if you have them!


Hi! I like writing! My hobbies: literature, philosophy, programming