angular-cli-github-pages
Angular CLI addon for deploying apps to GitHub pages.
If you need to quickly deploy and redeploy a small Angular 2 app via GitHub pages this angular-cli addon is for you!
This addon does the following:
- creates GitHub repo for the current project if one doesn't exist
- rebuilds the app at the current
HEAD - creates a local
gh-pagesbranch if one doesn't exist - moves your app to the
gh-pagesbranch and creates a commit - pushes the
gh-pagesbranch to github - returns back to the original
HEAD
Installation & Setup
Assuming that you have an angular-cli project running, all you need to do is install angular-cli-github-pages:
npm install --save-dev angular-cli-github-pagesUsage
Once that's done, you can checkout the branch you want to create the gh-page from(likely master) and run the command to build and commit it.
Then run ng github-pages:deploy in order to rebuild gh-pages branch and deploy it.
git checkout master
ng github-pages:deploy --message "Initial gh-pages release"Authentication
This addon relies on ssh authentication for all git operations that communicate with github.com. To simplify the authentication, be sure to (setup your ssh keys](https://help.github.com/articles/generating-ssh-keys/).
For repository creation, the addon needs to make a single https call to the GitHub api, for this user name and password are requested when the repo is being created.
Two factor authentication is currently not supported by this addon.
Authors
- Igor Minar
- Based on ember-cli-github-pages by Jake Craige