Install • Features • Demo • Discuss • Donations

A highly customizable habit-tracker
that is wired for systematic self-improvement

Features

• Habits that happen any amount of times in any amount of days
• Intutive design for habits that happen more than once a day
• Ability to set targets, and change them on the go
• Tracking numeric values (up to 2 billion) and setting numeric targets

You can see the features explained with examples on the landing. And you can also check out the demo version.

Custom heatmaps, with all the above features

Monochromatic (github/anki-style)

Numeric

Fractured

Designed specifically to track habits that have to happen many times per period (available up to 16, then defaults to numeric):

Or track habits that happen once in a blue moon:

Combine habits into projects

All displayed in a 1-dimensional mode, which is more suitable for day-to-day tracking:

Skilltrees

Excellent for planning and tracking progressions:

Other things you might find useful

• Keybindings for common actions
• Two themes available: light and dark
• Desktop-focused
• Polished mobile interface (browser-only, no app)
• Multiple accounts support
• Drag and drop projects or habits to rearrange their order
• Tooltips with the selected period's information (available when you hover on cells)
• Habit and project names are clickable and lead to their individual pages (all links also available in the sidebar)

Installation

Currently, there are three methods available:

wget -O docker-compose.yaml https://raw.githubusercontent.com/Vsein/Neohabit/refs/heads/main/docker-compose.yaml &&
wget -O .env https://raw.githubusercontent.com/Vsein/Neohabit/refs/heads/main/.env.example &&
wget -O Caddyfile https://raw.githubusercontent.com/Vsein/Neohabit/refs/heads/main/Caddyfile

docker compose up -d

docker compose logs

git clone https://github.com/Vsein/Neohabit.git && cd Neohabit

cp .env.example .env

docker compose up -d

docker compose logs

docker compose up --build --force-recreate

cd frontend && npm ci

go mod download

createdb neohabit_database

JWT_SECRET="SuperSecretInformation" \
PG_DSN="postgres://user:password@localhost:5432/neohabit_database?sslmode=disable" \
go run core/cmd/main.go -config core/config/config.yaml

By default, reverse proxies are set up with Caddy. If you prefer a different web server, here's a sample nginx.conf that was used previously. If you've set up the reverse proxy through Traefik, HAProxy or anything else - feel free to propose a sample snippet, so that it can be copy-pasted by others in the future for ease of use.

Upgrading

Ultimate vision

My ultimate vision for Neohabit is to have a public, community-driven archive of habits that may be imported into your database/account, with all the needed progressions. Somewhat similar to the Anki's shared decks, except for habits. I've implemented the core feature - the habit-tracking part, but the rest of it still needs some time to come together.

For example:

• There's the tasklist section that I want to integrate with habits, so you can see which habits are due today (currently the tasks are dangling in their own section, and weren't my development focus)
• The skilltrees are implemented, but right now there's no way to start habits directly based on the skills listed in the skilltree. I may even take skilltrees as the base for importing new habits, I guess it'll be more clear in the future.
• "The blocks" page is dangling as a section in the side menu, but I think it'll just be a link to a website with all the archived skilltrees/habits.
• Contribution guides and community support/groups

License

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

The AGPL-3.0 applies to the entire repository, including all historical commits. Any modified versions - especially when offered as a network service or SaaS - must comply with its copyleft terms.

This license is chosen specifically so that Neohabit remains open-source forever.

Donations

BTC: bc1qkt9xge2a8h3zt65ju7qkyvh6z6qjn6kdz8tm4a

XMR: 48F86e1vigUU8jUSf3kBYNJhMGp38dKxqBhga9sLz1Lr5qM8QqXrY3g4X8uQyqh7wQKhm7MpxSsSpdp1PGvY96jh1MGwyx8

To anyone who's kind enough to donate, thank you! Neohabit's development has cost me more than I'm comfortable admitting, if not financially then just in time alone. Spreading the word and mentioning this project to your friends is also welcome and much appreciated.