This package has been deprecated

Author message:

WARNING: This project has been renamed to deploy-to-github-pages. Install using deploy-to-github-pages instead.

🚀 deploy-directory-on-branch-to-gh-pages

A Node and CLI tool that makes deploying a directory on a branch to GitHub pages easy and automatic, to help your peers QA your built docs/demos easily for better feedback.

It also sends a status to a Pull request, if one exists:

Installation

npm install -D deploy-directory-on-branch-to-gh-pages

Usage

CLI

deploy-directory-on-branch-to-gh-pages [...options]

Node

const deploy = require('deploy-directory-on-branch-to-gh-pages');

deploy(options).catch(err => { console.log(err); })

Options

Option	flag	description	default	env variable	required	required with CircleCI
directory	-d	directory you wish to deploy	'public'		*	*
token	-t	GitHub token		GITHUB_TOKEN	*	*
owner	-o	GitHub repo owner/org			*
repo	-r	GitHub repo name			*
branch	-b	branch name			*
buildUrl	-u	link displayed when deployment fails

Therefore, if ran from CircleCI with a GITHUB_TOKEN environment variable present and the directory to be deployed is named public, no configuration options are needed, so just the following is enough:

deploy-directory-on-branch-to-gh-pages

or

deploy().catch(err => { console.log(err); })

Contributing

1. Run tests with yarn test.
2. Develop.
3. Bump version number in package.json according to semver and add an item that a release will be based on to CHANGELOG.md.
4. Submit your pull request from a feature branch and get code reviewed.
5. If the pull request is approved and the CircleCI build passes, you will be able to squash and merge.
6. Code will automatically be released to GitHub and published to npm according to the version specified in the changelog and package.json.

Other

For features and bugs, feel free to add issues or contribute.