Deploying

You are placing your docs inside the directory of your project;
You are using the default build output location (.vuepress/dist);
VuePress is installed as a local dependency in your project, and you have setup the following npm scripts:

Set correct base in docs/.vuepress/config.js.

If you are deploying to https://<USERNAME>.github.io/, you can omit base as it defaults to "/".

If you are deploying to , (that is your repository is at https://github.com/<USERNAME>/<REPO>), set base to "/<REPO>/".

Inside your project, create deploy.sh with the following content (with highlighted lines uncommented appropriately) and run it to deploy:

#!/usr/bin/env sh
# abort on errors
set -e
# build
npm run docs:build
# navigate into the build output directory
cd docs/.vuepress/dist
# if you are deploying to a custom domain
# echo 'www.example.com' > CNAME
git init
git add -A
git commit -m 'deploy'
# if you are deploying to https://<USERNAME>.github.io
# if you are deploying to https://<USERNAME>.github.io/<REPO>
# git push -f git@github.com:<USERNAME>/<REPO>.git master:gh-pages
cd -

TIP

You can also run the above script in your CI setup to enable automatic deployment on each push.

Set correct base in docs/.vuepress/config.js.

If you are deploying to or GROUP>.github.io/, you can omit as it defaults to "/".

If you are deploying to https://<USERNAME or GROUP>.github.io/<REPO>/, (that is your repository is at ;), set base to "/<REPO>/".

Create a file named .travis.yml in the root of your project.
Run yarn or npm install locally and commit the generated lockfile (i.e. yarn.lock or package-lock.json).
Use GitHub Pages deploy provider template and follow the travis documentation.

language: node_js
node_js:
  - lts/*
install:
  - yarn install # npm ci
script:
  - yarn docs:build # npm run docs:build
deploy:
  provider: pages
  skip_cleanup: true
  local_dir: docs/.vuepress/dist
  github_token: $GITHUB_TOKEN # A token generated on GitHub allowing Travis to push code on you repository. Set in the Travis settings page of your repository, as a secure variable
  keep_history: true
  on:
    branch: master

GitLab Pages and GitLab CI

Set correct base in docs/.vuepress/config.js.

If you are deploying to https://<USERNAME or GROUP>.gitlab.io/<REPO>/, (that is your repository is at ;), set base to "/<REPO>/".

Set dest in .vuepress/config.js to public.
Create a file called .gitlab-ci.yml in the root of your project with the content below. This will build and deploy your site whenever you make changes to your content.

Netlify

On , setup up a new project from GitHub with the following settings:
Build Command: yarn docs:build or
Publish directory: docs/.vuepress/dist
Hit the deploy button!

Make sure you have firebase-tools installed.

{
 "hosting": {
   "public": "./docs/.vuepress/dist",
   "ignore": []
 }
}

.firebaserc:

{
 "projects": {
   "default": "<YOUR_FIREBASE_ID>"
 }
}

After running yarn docs:build or npm run docs:build, deploy with the command firebase deploy.

Surge

First install surge, if you haven’t already.
Run yarn docs:build or npm run docs:build.
Deploy to surge, by typing surge docs/.vuepress/dist.

You can also deploy to a by adding surge docs/.vuepress/dist yourdomain.com.

First install Heroku CLI.
Create a Heroku account .
Run heroku login and fill in your Heroku credentials:

Create a file called static.json in the root of your project with the content below:

static.json:

{
  "root": "./docs/.vuepress/dist"
}

Set up your Heroku git remote:

# version change
git init
git add .
git commit -m "My site ready for deployment."
# creates a new app with a specified name
heroku apps:create example
# set buildpack for static sites

Deploying Your Site

Now

Please check out .