Mobile app for the Eventkit (conference management framework)

• First install Node.js
• Then, install the latest Cordova and Ionic command-line tools npm install -g cordova ionic
• Follow the Android and iOS platform guides to install required platform dependencies

git clone https://github.com/YOUR-GITHUB-USERNAME/eventkit-mobile.git

git remote add upstream https://github.com/leoshtika/eventkit-mobile.git

ionic state reset

ionic serve

Having prepared your develop environment as explained above you can now start working on a feature or bugfix.

All new features and bug fixes should have an associated issue to provide a single point of reference for discussion and documentation. If you do not find an existing issue matching what you intend to work on, please open a new issue or create a pull request directly if it is straightforward fix.

You should start at this point for every new contribution to make sure you are working on the latest code.

git checkout master
git pull upstream master

Each separate bug fix or change should go in its own branch. Branch names should be descriptive and start with the number of the issue that your code relates to. If you aren't fixing any particular issue, just skip number. For example:

git checkout -b 999-name-of-your-branch

Make sure it works :)

git add --all
git commit -m "Resolve #999: A brief description of this change"

Before pushing your code to GitHub make sure to integrate upstream changes into your local repository

git checkout master
git pull upstream master
git checkout 999-name-of-your-branch
git rebase master

This ensures that your changes can be merged with one click.

Squash commits This step is not always necessary, but is required when your commit history is full of small, unimportant commits.

git rebase -i master

git push -u origin 999-name-of-your-branch

Go to your repository on GitHub and click "Pull Request", choose 'develop' as the base branch and your '999-name-of-your-branch' as the head branch and enter some more details in the comment box. To link the pull request to the issue put anywhere in the pull comment #999 where 999 is the issue number. Note that each pull-request should fix a single change.

Someone will review your code, and you might be asked to make some changes, if so go to step #5 (you don't need to open another pull request if your current one is still open). If your code is accepted it will be merged into the main branch and become part of the next release.

After your code was either accepted or declined you can delete branches you've worked with from your local repository and origin.

git checkout master
git branch -D 999-name-of-your-branch
git push origin --delete 999-name-of-your-branch