Habitica Android

Abstract

1. Introduction

Due to changes in the tech landscape and in how our player base interacts with Habitica on various platforms, we have made the decision to pause our acceptance of code-based contributions (Blacksmith tiers). Our codebase will remain open-source and publicly visible. If you’d like to know more about this pause, you can find additional details on the GitHub wiki.

This repository prohibits the submission of code generated by large language models (LLMs), AI coding assistants, or automated generation tools. All code must be authored entirely by humans. AI-assisted commits will be rejected during pull request reviews.

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.

2. Objective

Native Android app for Habitica

This project demonstrates how Kotlin, Java, Android can be applied to a real-world Mobile App Development problem.

4. Technology Stack

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

• Android Studio (latest)
• JDK 17
• Android device or emulator
• JDK 11 or later
• Maven / Gradle
• IntelliJ IDEA, Eclipse or Android Studio
• Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/HabitRPG/habitica-android.git
cd habitica-android

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

• Add push notifications with Firebase Cloud Messaging
• Add offline support with local caching
• Publish an internal test build on the Play Store

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

1. Which framework is used and why (native vs cross-platform)?
2. How is app state managed across screens?
3. Where is the data stored — locally, Firebase or a REST backend?
4. How are permissions (camera, location, storage) handled?
5. How would you publish this app to the Play Store / App Store?

9. Source Code & License

This project is developed by HabitRPG and published on GitHub under the GNU General Public License v3.0. Please follow the license terms and credit the original author when you use or modify this code.