How to contribute

• Frontend Configuration
• Data Fetching Confugration

Initial Setup

• create a github account and click the "Fork" button at the top right to fork this repository
• copy the ssh address (ex. [email protected]:PeaceGeeksSociety/services-advisor.git) and use it to clone the project

git clone <ssh address here>

• add services advisor as an upstream remote

git remote add upstream [email protected]:PeaceGeeksSociety/services-advisor.git

Adding Features

No new feature code should be merged into master

All new feature code should be pull requested into a feature branch. We want to leave master for bugfixes until we are ready to do a full new release to http://advisor.unhcr.jo/.

To create a new branch in the main repo

git checkout -b feature_name
git push upstream feature_name

To create a pull request, make your changes and commit. Then

git push origin # will push your branch to YOUR fork

Go to your fork: https://github.com/your-username-here/services-advisor and you should see a button for your recently pushed branch that you can click to make a pull request.

Make sure that the branch you're pull requesting into is the feature branch, not master.

Updating with what others have written

Since the updates go into the main repository and not your fork, you'll occasionally need to get the latest changes from the main repo.

git fetch upstream

Then you can merge or rebase those changes onto your branches.

git checkout master
git rebase upstream/master

# or
git checkout feature
git merge upstream/feature

Building

This build uses npm to manage javascript dependencies and Webpack for bundling.

Versions of node and npm we know work: npm 3.3.12 node 5.1.0

To build the js/css:

• run npm install to download the 3rd party libs in package.json
• cp src/site-specific-config.js.dist src/site-specific-config.js to use the default config

For development

• run npm start

This will:

• compile javascript, css and other assets
• start watching for changes
• run a local server (defaults to localhost:8080)
• open a tab pointing to the site in your web browser

Preparing for production

• run npm run build to create minified javascript and css files ready for production.

To update services data

Run this script. Must have node installed, and have run npm install

service-list-retrieval/update-services.sh

Developing with Docker

Run docker-compose up -d