Native Android
Clone or download
Failed to load latest commit information.
.tx Fix various issues Mar 9, 2018
Habitica Fix incorrect language code for Croatian Language in LanguageHelper Nov 14, 2018
_gsdata_ Merge branch 'develop' of Feb 7, 2017
fastlane Fix minor issues Nov 13, 2018
gradle/wrapper Implement username changes Oct 17, 2018
projectFilesBackup/.idea update to android studio 2.3 Mar 23, 2017
reports/profile Rewrite task lists May 10, 2016
seeds-sdk Update to AndroidX Nov 6, 2018
translations update translations Nov 12, 2018
.gitignore Implement new welcome screen Nov 5, 2018
.gradletasknamecache Initial commit Apr 12, 2015
.travis.yml Fix travis setup to accept 26.0.2 build tools Jan 29, 2018
AndroidStyle.xml Rename code style with habitica Nov 17, 2017
Gemfile Fix various username bugs Nov 6, 2018
Gemfile.lock Tweak UI Nov 7, 2018
LICENSE Added GPLv3 to be consistent with the habitrpg Jan 1, 2016 revert Mar 8, 2017 readme spelling Nov 12, 2018
build.gradle Reorder google() in build.gradle to fix build errors Nov 12, 2018
config-android.json support old reward column Sep 7, 2017
detekt.yml fix various code smell issues Jul 25, 2018 Update to AndroidX Nov 6, 2018
gradlew Apply avatar transformations (if items available) / update gradle Oct 3, 2016
gradlew.bat Apply avatar transformations (if items available) / update gradle Oct 3, 2016 Show world boss in menu Feb 8, 2018 Show world boss in menu Feb 8, 2018
habitica.resources.example Code cleanup Jul 25, 2018 Rename code style with habitica Nov 17, 2017
settings.gradle implement seeds sdk Dec 7, 2016 Initial commit Apr 12, 2015
store_strings.xml Move all db access to repositories Apr 20, 2017

Habitica for Android

Join the chat at

Habitica 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:

Get it on Google Play

Having the application installed is a good way to be notified of new releases. However, clicking "Watch" on this repository will allow GitHub to email you whenever we publish a release.

What's New

See the project's Releases page for a list of versions with their changelogs.

View Releases

If you Watch this repository, GitHub will send you an email every time we publish an update.


For an introduction to the technologies used and how the software is organized, refer to Contributing to Habitica - "Coders (Web & Mobile)" section.

Thank you very much to all contributors.

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
    • Don't forget to include your Habitica User ID, so that we can count your contribution towards your contributor tier

Code Style Guidelines

We follow the code style guidelines outlined in Android Code Style Guidelines for Contributors.

You can install our code style scheme to Intellij and/or Android Studio via this shell command:

$ ./

Build Instructions

Config Files

Setup Habitica build config files by simply copying the example habitica files.

$ cp
$ cp habitica.resources.example habitica.resources
$ cp Habitica/google-services.json.example Habitica/google-services.json (Get .json from Firebase Console)

Note: this is the default production file for If you want to use a local habitica server, please modify the values in the properties file accordingly.

Building also requires a google-services.json file: Register/Login to Firebase, create new project called Habitica, create two apps, and Download google-services.json, copy to Habitica/google-services.json.