vue-cli-plugin-gh-pages

Vue CLI plugin to publish to GitHub pages (or any other branch anywhere else).

Install

vue add gh-pages

N.B. This plugin requires Git >=1.9.

Usage

npm run gh-pages

The generator automatically adds this script, however, you are free to modify this.

Options

This package is a wrapper around gh-pages, so the same options apply to this package. Please see the documentation of gh-pages for a list of supported options. These options must be defined in vue.config.js under pluginOptions.ghPages e.g.

module.exports = {
    pluginOptions: {
        ghPages: {
            message: 'Updates',
        },
    },
};

All options can also be set using the Vue CLI UI. In addition, most options can also be defined on the command line. Please run npm run gh-pages -- --help to see a list of supported CLI options.

Functions

The message and tag options can be a function and their return value will be used. This allows you to create, for example, time based commit messages or create a tag based on certain information.

N.B. When these options are defined as a function, they can not be edited using the Vue CLI UI!

Changelog

Please see CHANGELOG for more information about what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please contact Jasper Zonneveld directly or report to NPM instead of using the issue tracker.

License

The MIT License (MIT). Please see License File for more information.

This package is not affiliated with nor endorsed by GitHub. GitHub is a registered trademark of GitHub Inc.

Credits

• Jasper Zonneveld
• All Contributors

This package is a Vue CLI plugin wrapping gh-pages. Many thanks to Tim Schaub for his excellent package!