# Habitica — Gamify Your Habits and Productivity

> A habit-building and productivity app that treats your real-life goals like an RPG, rewarding you with experience, gold, and gear as you complete tasks and build streaks.

## Install

Save as a script file and run:

# Habitica — Gamify Your Habits and Productivity

## Quick Use
```bash
git clone https://github.com/HabitRPG/habitica.git
cd habitica
cp config.json.example config.json
npm install && npm start
# Open http://localhost:3000
```

## Introduction
Habitica turns your daily tasks, habits, and to-do lists into a role-playing game. You create a pixel-art avatar that levels up, earns gold, and unlocks gear as you check off real-world goals. Missing tasks costs your character health, providing motivation through gentle gamification.

## What Habitica Does
- Tracks habits (positive/negative), daily recurring tasks, and one-off to-dos
- Awards experience points and gold for completing tasks, with health penalties for misses
- Provides party and guild systems for accountability with friends or communities
- Offers boss battles and quests that require the whole party to stay on track
- Includes pets, mounts, equipment, and cosmetic rewards as long-term incentives

## Architecture Overview
Habitica is a Node.js application using Express on the backend with MongoDB as its primary data store. The web client is built with Vue.js. A cron job runs daily per user to apply damage for missed dailies and recalculate streaks. The mobile apps (iOS and Android) share the same REST API.

## Self-Hosting & Configuration
- Clone the repo and copy `config.json.example` to `config.json` with your settings
- Requires Node.js 18+ and a running MongoDB 6+ instance
- Set MongoDB connection URI, session secret, and optional SMTP config in `config.json`
- Run `npm start` for development or use PM2/systemd for production
- No official Docker image, but community Dockerfiles exist in the repo

## Key Features
- RPG mechanics including classes (Warrior, Mage, Healer, Rogue) with unique abilities
- Streak tracking that rewards consistency and penalizes broken chains
- Challenge system for creating shared task templates within guilds
- Full REST API for building custom integrations and bots
- Mobile apps for iOS and Android with push notification reminders

## Comparison with Similar Tools
- **Todoist** — powerful task manager but no gamification layer
- **TickTick** — includes habit tracking with Pomodoro but no RPG elements
- **Streaks (iOS)** — focused on streak tracking only; Habitica adds social quests and rewards
- **SuperBetter** — gamified resilience app; Habitica covers broader daily task management
- **Forest** — focuses on focus sessions; Habitica covers the full productivity workflow

## FAQ
**Q: Can I self-host Habitica for my team?**
A: Yes. The full source is open under GPLv3. Self-hosting gives you control over data and lets you customize game mechanics.

**Q: Does the gamification actually help with productivity?**
A: Many users report improved consistency due to streak motivation and social accountability through party quests. Results vary by individual.

**Q: What happens when I miss a daily task?**
A: Your character takes damage. If health reaches zero, you lose a level, one random piece of equipment, and some gold, then respawn.

**Q: Is there an API for integrations?**
A: Yes. Habitica provides a full REST API. Community integrations exist for Google Calendar, Todoist import, and browser extensions.

## Sources
- https://github.com/HabitRPG/habitica
- https://habitica.com/apidoc/

---
Source: https://tokrepo.com/en/workflows/c9e09c58-3e02-11f1-9bc6-00163e2b0d79
Author: Script Depot