Repolode
HabitRPG

HabitRPG/habitica

An open-source habit tracker that turns your daily goals and to-dos into a role-playing game, with XP, HP, Gold and gear.

Open-source alternative to:HabitifyStreaks

Stars
14,238
Forks
4,455
Open issues
131
Last commit
4 hours ago

What is it?

Habitica is a habit-building app that treats everyday life as a role-playing game. You complete habits, dailies and to-do items to earn experience and gold, and you lose HP when you miss daily tasks. Gaining levels and spending gold on weapons and armor are the core loop that keeps the tracking engaging.

The project is a JavaScript web application built with Node.js and Express on the backend, MongoDB for storage, and Vue.js for the frontend. The repository contains the web app and its server code, with setup instructions for running a local development instance.

The README also points to separate repositories for the Android and iOS apps, and notes that third-party tools using the Habitica API should follow the published API usage guidelines. As of August 4, 2026, public pull request submissions are paused, and the codebase remains open and publicly visible.

Key features

  • 01Turns habits, dailies and to-dos into tasks that award experience and gold.
  • 02Deducts HP for missed daily tasks, adding consequences to falling behind.
  • 03Lets players spend earned gold on weapons and armor in the game.
  • 04Built with Node.js, Express, MongoDB and Vue.js.
  • 05Includes guides for setting up a local development environment.

Use cases

  • Building a daily habit routine with game-style rewards and penalties.
  • Studying how a gamified productivity app is structured with Vue and Express.
  • Running a local Habitica instance for development or testing.

Quick start

  1. 1

    Use the hosted version at habitica.com

  2. 2

    For a local development setup, follow the setup guide on the project wiki

Things to know

  • Public code pull requests are paused as of August 4, 2026.
  • The repository prohibits AI-generated code, and AI-assisted commits will be rejected.
  • The license is not clearly identified in the metadata, so check the LICENSE file before reuse.

Topics

FAQ

What is habitica?
An open-source habit tracker that turns your daily goals and to-dos into a role-playing game, with XP, HP, Gold and gear. Habitica is a habit-building app that treats everyday life as a role-playing game. You complete habits, dailies and to-do items to earn experience and gold, and you lose HP when you miss daily tasks. Gaining levels and spending gold on weapons and armor are the core loop that keeps the tracking engaging.
Is habitica free to use? What license does it have?
habitica is open source under the Other license. Check the license terms before using it in commercial products.
Is habitica still maintained?
Actively maintained. The last commit to habitica was on Oct 21, 2026.
What can I use habitica for?
Building a daily habit routine with game-style rewards and penalties. Studying how a gamified productivity app is structured with Vue and Express. Running a local Habitica instance for development or testing.
How do I install habitica?
Use the hosted version at habitica.com For a local development setup, follow the setup guide on the project wiki
Where can I get habitica?
The source code and installation instructions are on GitHub: https://github.com/HabitRPG/habitica

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects