2015-06-20 18:49:04 +00:00
# Habitica for Android
2015-12-17 14:30:51 +00:00
[](https://gitter.im/HabitRPG/habitrpg-android?utm_source=badge& utm_medium=badge& utm_campaign=pr-badge& utm_content=badge)
2015-06-20 18:49:04 +00:00
2015-12-12 19:33:14 +00:00
[Habitica ](https://habitica.com ) is an open source habit building program which treats your life like a Role Playing Game. Level up as you succeed, lose HP as you fail, earn money to buy weapons and armor. This repository is related to the Android Native Application.
It's also on Google Play:
< a href = "https://play.google.com/store/apps/details?id=com.habitrpg.android.habitica" >
< img alt = "Get it on Google Play"
2016-01-26 09:21:33 +00:00
width="185"
src="https://play.google.com/intl/en_us/badges/images/generic/en-play-badge.png" />
2015-12-12 19:33:14 +00:00
< / a >
2015-12-16 05:05:09 +00:00
Having the application installed is a good way to be notified of new releases. However, clicking "Watch" on this
2015-12-12 19:35:07 +00:00
repository will allow GitHub to email you whenever we publish a release.
2015-12-12 19:33:14 +00:00
# What's New
See the project's Releases page for a list of versions with their changelogs.
##### [View Releases](https://github.com/HabitRPG/habitrpg-android/releases)
2015-12-12 19:34:37 +00:00
If you Watch this repository, GitHub will send you an email every time we publish an update.
2015-12-12 19:33:14 +00:00
## Contributing
For an introduction to the technologies used and how the software is organized, refer to [Contributing to Habitica ](http://habitica.wikia.com/wiki/Contributing_to_Habitica#Coders_.28Web_.26_Mobile.29 ) - "Coders (Web & Mobile)" section.
2015-12-16 05:05:09 +00:00
Thank you very much [to all contributors ](https://github.com/HabitRPG/habitrpg-android/graphs/contributors ).
2015-12-12 19:33:14 +00:00
#### Steps for contributing to this repository:
1. Fork it
2. Create your feature branch: `git checkout -b my-new-feature`
3. Commit your changes: `git commit -am 'Add some feature'`
4. Push to the branch: `git push origin my-new-feature`
5. Create new Pull Request
2015-12-16 05:05:09 +00:00
* Don't forget to include your Habitica User ID, so that we can count your contributrion towards your contributor tier
2015-12-12 19:33:14 +00:00
2016-04-27 02:44:33 +00:00
### Code Style Guidelines
We follow the code style guidelines outlined in [Android Code Style Guidelines for Contributors ](https://source.android.com/source/code-style.html ).
You can install our code style scheme to Intellij and/or Android Studio via this shell command:
$ ./install-codestyle.sh
2016-04-22 03:40:40 +00:00
## Build Instructions
### Config File
Setup Habitica build config file by simply copying the example habitica properties file.
$ cp habitica.properties.example habitica.properties
Note: this is the default production `habitica.properties` file for habitica.com. If you
want to use a local habitica server, please modify the values in the properties file accordingly.
