We have a very lightweight development environment that makes updating code fast and easy. This is a step-by-step guide to setting up a local development environment that will let you contribute back to the project.
Make sure you have installed and configured the following products on your development machine:
- Git
- Node.js
- Chrome browser (run tests)
Go to ng-lightning repository and click the "Fork" button. Follow the GitHub documentation for forking and cloning.
You can then add upstream
path to monitor the main repository that active development happens on. While you won't have push access to upstream
, you will have pull access, allowing you to pull in the latest code whenever you want.
Run the following in your repository:
git remote add upstream git@github.com:ng-lightning/ng-lightning.git
Get all the necessary dependencies needed to build, test and run demo page by running:
yarn install
yarn build
The best way to see your changes in action, is to use our demo page locally. Run:
yarn start
which will create a development server accessible through http:localhost:1111
.
yarn test
If you want to run your tests in watch mode, you can use:
yarn tdd
If you want and already have a personal account, you can run tests on Saucelabs, just by passing the --saucelabs
flag.
The setup assumes that eiter process.env.SAUCE_USERNAME
and process.env.SAUCE_ACCESS_KEY
are set or a saucelabs.json
file exists inside the root folder, with the following format.
{
"username": "YOUR_SAUCE_USERNAME",
"accessKey": "YOUR_SAUCE_ACCESS_KEY"
}
When you believe it's time to release a new version, you can do it through an interactive process, by using:
yarn release
Demo site published to gh-pages
branch can be updated at any time using:
yarn demo:release