# Project pack: Habitica @ 11b3150

Facts about **Habitica** for an AI following the [BespokeAI handover guide](https://handoff.bespokeai.software/guide/v4.md). Pinned to one version; never changes after publication.

> Habitica treats your real life like a game. Habits, daily tasks and to-dos earn experience and gold for your avatar, and missed tasks cost health. You can join parties, fight monsters together and spend gold on gear. It is popular with people who find ordinary to-do lists hard to stick with.

## Setup path (checked 2026-11-03)
- **Needs Docker.** Tell the person before any setup work; no light non-Docker route is documented upstream. The repository ships a docker-compose.yml for its development stack (Node + MongoDB). Docker Desktop on Windows may need a computer restart and an admin-only Windows feature (virtualisation); say so and let the person decide.
- Hosted alternative, **the person's choice, never a default**: habitica.com (https://habitica.com); cost/account: official hosted service; account required, price not verified here.
- Verdict source: https://raw.githubusercontent.com/HabitRPG/habitica/HEAD/docker-compose.yml
- You may be unable to download source archives or run commands in this session. The person downloads and runs things; if you cannot fetch something, give any changed file in full in chat with its path.

## Version and source
- Repository: https://github.com/HabitRPG/habitica
- Pinned commit: `11b3150d90e6f93747b2649587ca7d18961d7029`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/HabitRPG/habitica/archive/11b3150d90e6f93747b2649587ca7d18961d7029.zip
- Fresh checkout (only if you have a shell and git): use the commands below in an empty folder. If this exact source is already checked out, keep your branch and use the development command; do not clone again or reset local changes.
- Live demo: https://habitica.com/. The official hosted app. It is free to use, with an optional subscription.
- Licence: **GPL-3.0-only**. Free to use and change. If you share your changed version with other people (give them the code or app), you must share your source code under the same licence. Using it privately for yourself or your household has no extra obligations. Some artwork is under separate Creative Commons licences, one of which forbids commercial use. Check before reusing images.

## Commands from the pinned source
- Developer commands (they may use Docker):

  ```sh
  git clone https://github.com/HabitRPG/habitica bespoke-habitica
  cd bespoke-habitica
  git checkout --detach 11b3150d90e6f93747b2649587ca7d18961d7029
  # Prepare development requirements and local configuration first.
  cp config.json.example config.json
  npm install
  npm run client:install
  npm start
  ```

- Separate trial of the current upstream release (not your changes; sample data and a separate data directory only):

  ```sh
  Use the free hosted app at https://habitica.com. To run your own copy, follow the 'Setting up Habitica Locally' guide in the Habitica wiki.
  ```
- Tools these commands use: Node 22, npm, and MongoDB, or Docker for the development stack
- Develop: `npm start  # and, in another terminal: npm run client:dev`
- Test: `npm test`
- Check/lint: `npm run lint`
- Stack: javascript (Node.js, Express, Vue, Mongoose, Gulp). Difficulty for a non-developer with an AI: **advanced**. A large Node and Vue code base with its own game content, sprites and a MongoDB database. Running it locally is doable; the hosted app is the easiest way to use it.
Personal data: **yes**. Stored in: A MongoDB database. Secrets are entered by the person, never in chat.

---
Later, only when a step needs it: [reference.md](https://handoff.bespokeai.software/p/habitica/11b3150/r3/reference.md) (customisation points, must-keep-working, data and costs, coding conventions) · [hosting.md](https://handoff.bespokeai.software/p/habitica/11b3150/r3/hosting.md) (long-term hosting; hosts are paid third parties) · [bespoke.yaml](https://handoff.bespokeai.software/p/habitica/11b3150/r3/bespoke.yaml) · [SKILL.md](https://handoff.bespokeai.software/p/habitica/11b3150/r3/SKILL.md)