If you need to throw up a quick example of your addon in action, this is the addon for you!

This addon provides new command(s) to help manage a gh-pages branch for your addon. It's an addon for addons.

First you need to install ember-cli-github-pages:

ember-cli - 0.2.3 or newer

ember install ember-cli-github-pages

ember-cli - 0.1.5 to 0.2.3

ember install:addon ember-cli-github-pages

ember-cli - 0.1.4 and below

npm install --save-dev ember-cli-github-pages
ember generate ember-cli-github-pages

In order to have any assets you have in your repo load correctly you need to add the following to your tests/dummy/config/environment.js file:

if (environment === 'production') {
  ENV.baseURL = '/name-of-your-repo'
}

Commit these changes git add -A && git commit -m "Added ember-cli-github-pages addon"

Then you need to create the gh-pages branch and remove the unnecessary files:

git checkout --orphan gh-pages && rm -rf `ls -a | grep -vE '\.gitignore|\.git|node_modules|bower_components|(^[.]{1,2}/?$)'` && git add -A && git commit -m "initial gh-pages commit"

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 ember github-pages:commit --message "some commit message" in order to rebuild gh-pages branch.

git checkout master
ember github-pages:commit --message "Initial gh-pages release"

While in general, github repo pages will serve the content in the gh-pages branch, org and user pages serve content in the master branch. When using this addon to develop a Org or User page, edit your Ember Application on an alternate branch such as ember. Once you are ready to build the application and send to GitHub you can either:

• add the --branch master option to the ember github-pages:commit command
• make the gh-pages branch on your local machine track the master branch on origin via the command:

git branch --set-upstream gh-pages origin/master

You may optionally specify an ember build environment and a branch name as parameters

git checkout master
ember github-pages:commit --message "Initial demo app release" \
                          --branch="my-demo-app" \
                          --environment=development

You will still need to push the gh-pages branch up to github using git. Once you do that you can access the repo at http://username.github.io/repo-name. It may take a few minutes after pushing the code to show up.

• Jake Craige

We are very thankful for our many contributors

Licensed under the MIT license