by Sai gowtham

How to deploy a vue app to GitHub pages

In this tutorial, we are going to learn about deploying a vue.js app to GitHub pages.

We are deploying our vue app in four steps.

Step 1

Push your vue.js app to a GitHub repository.

vue-app-github-repo

Step 2

Create a new file called vue.config.js in your root app folder.

vue config

Now add the below code to vue.config.js file by replacing with your publicPath.

vue.config.js
module.exports = {
    publicPath: '/vue-app-deploy-example/'}

Note: publicPath is the GitHub repository name.

Step 3

Now, we are creating a deploy script file which helps us to deploy our app to GitHub pages.

Create a new file called deploy.sh in your root app folder and add the below code by replacing with your GitHub username and repository name.

deploy.sh
#!/usr/bin/env sh

# abort on errors
set -e

# build
npm run build

# navigate into the build output directory
cd dist

git init
git add -A
git commit -m 'deploy'

git push -f git@github.com:<USERNAME>/<REPO-NAME>.git master:gh-pages
cd -

Step 4: Running deploy script

Open your terminal and run the below command to successfully deploy your app to GitHub pages

bash deploy.sh

vue-app-deploy-script

Once you successfully completed all above steps now open your vue app GitHub repo and click on settings tab then scroll down to GitHub pages section to see your app URL.

vue-app-deployed-github-pages

Top Udemy Courses

JavaScript - The Complete Guide 2020 (Beginner + Advanced)
JavaScript - The Complete Guide 2020 (Beginner + Advanced)
45,614 students enrolled
52 hours of video content
View Course
React - The Complete Guide (incl Hooks, React Router, Redux)
React - The Complete Guide (incl Hooks, React Router, Redux)
284,472 students enrolled
40 hours of video content
View Course
Vue - The Complete Guide (w/ Router, Vuex, Composition API)
Vue - The Complete Guide (w/ Router, Vuex, Composition API)
130,921 students enrolled
48.5 hours of video content
View Course