Navigate back to the homepage

Deploying Vue App from Github to Netlify

Ezekiel Ekunola
February 25th, 2020 · 2 min read

In this article, We will be going through the process of deploying a Vue application from Github to Netlify.

If you have a project structure where the Vue app is NOT nested in a sub-directory like in the example shown below

project structure

You can use the following steps to deploy:

  • Push your code to Github
  • Connect your Github account to your Netlify account
  • Select the project you want to deploy
  • Add commands
    • Build Command (npm run build): This is the command that would be run for every build/deployment on Netlify. The Vue command for building and bundling our files is npm run build.
    • Publish Directory (dist): This is the folder that contains the files that was generated from the build command. After running the build command, a dist folder is generated and it contains our minified and compiled production ready code.
  • Deploy project

See example in the image below

In a case where your Vue application is available in a nested directory like the example shown below

Note that the Vue project in the example above is nested in a client directory.

Add a netlify.toml file to the root of your project, and add the configuration below to the file.

2 command = "npm run build"
3 publish="dist"
4 base = "client"
5 # The base directory should be the path to the nested Vue project

Once added, push the changes to Github. Netlify should automatically deploy the changes, if not, deploy the changes manually.

Note: netlify.toml is a configuration file where you can specify how Netlify should build/run your application. A lot can be accomplished with the netlify.toml file. Find out more about the netlify.toml file here.


If you’ve made use of routing in your project, and you want to load a particular route straight from your URL, you would run into an issue where Netlify would throw an error (“page not found”) as shown in the example below

To solve/fix the issue, you can add the following code below to your netlify.toml file.

2 from = "/*"
3 to = "/index.html"
4 status = 200

Once added, push the changes to Github and re-deploy the project. Once deployed, your application should no longer throw errors. See the example below.

Environment Variables

If you’ve made use of environment variables in your project, you can also add them to Netlify by following the steps shown in the image below

Note that If you’ve created the Vue application using vue-cli, you need to add the VUE_APP prefix to all your environment variables.


In this article, we’ve been able to take a look at how to deploy a Vue application from Github to Netlify, how to fix routing issues that can come up after deployment and well as how to add environment variables on Netlify.

If you have any questions or feedback about this article, feel free to reach out.

Thanks for reading.

More articles from easybuoy

Understanding the package.json file

What is a package.json file

February 23rd, 2020 · 3 min read

Setting up Domain with Namecheap & Netlify

In this article, I would be showing how to connect...

January 22nd, 2020 · 1 min read
© 2018–2020 easybuoy
Link to $ to $ to $ to $