Yeoman generator that scaffolds out a front-end web app using gulp-armadillo for the build process and Rapid Design System for the SCSS library.
Create a github.ibm.com account
Create a travis.innovate.ibm account
Generate an SSH Key and add it to your GitHub Enterprise account
- If you previously installed Node through the Node.js website, uninstall using these instructions
- Install node the right way with Homebrew: http://blog.teamtreehouse.com/install-node-js-npm-mac
- Fixing npm permissions (if you don't want to use Homebrew): https://docs.npmjs.com/getting-started/fixing-npm-permissions
Install Gulp globally:
npm install -g gulp
First, you need to install Yeoman. You only have to ask for her once, then she packs up and moves into your hard drive.
Open up your terminal, and in any directory, run:
npm install -g yo
Rapid Generator is available as a package on IBM’s NPM Enterprise registry. To get access, follow these instructions to authenticate with your w3id. You can initiate the authentication by logging in with the @whitewater scope:
npm login --registry=https://npm-registry.whitewater.ibm.com --scope=@whitewater
Yeoman travels light. She didn't pack any generators when she moved in. You can think of a generator like a plug-in, and like Yeoman herself, you only have to ask for generators once. This project is all about the Rapid Design System, so let’s grab that generator.
To install generator-rapid:
npm install -g @whitewater/generator-rapid
Then, back in your development directory, run Yeoman to create a new project:
yo @whitewater/rapid
Almost everything is set up for you to deploy your site to GitHub Pages with Travis CI.
You need to create an personal access token with the repo scope. Keep this a secret! It's what lets Travis CI write to your gh-pages branch and deploy for you!
Navigate to https://travis.innovate.ibm.com/profile/{github-username}, click sync now, and then toggle your repository on
Once you've got your token, in your Travis CI environment variables, add a GH_TOKEN variable and set it to your token.
Back in your terminal, push your project up to GitHub
git add .
git commit -m ":tada: Initial commit"
git push origin master