Your open-source habit companion

Small habits.
Meaningful change

Build a life that feels a little more like yours. Track the habits that matter, celebrate each day you show up, and let progress grow at its own pace.

Get started with Docker Take a look around

Free and open sourceOpen source and self-hostable

A little adds up7 days of showing up ✳

HabitMaker preview: your habits and the days you completed them, all in one calm home screen.

One day at a timeYour pace. Your progress.

Made for real life, not perfect streaksBuilt in the open, with care

A gentler kind of progress

Good habits grow from the days you do show up.

Make room for what matters

Choose healthy routines that fit your life, from reading and movement to moments of rest.

Notice the progress

Mark each day and revisit your calendar to see steady effort—not a demand for perfection.

A nudge, when you need one

Optional daily web push reminders help your intentions find a place in your day.

Open source, by nature

HabitMaker is built in public. Explore the code, share an idea, or help shape what comes next.

A peek inside

Simple tools for the long game.

A little structure, a little encouragement, and plenty of room to find your own rhythm.

Illustrative app preview showing a home screen with a reading habit and weekly progress.

A home for your habits

See your daily routines and the small wins that add up.

Progress you can look back on

A calm calendar makes your consistency easy to spot.

Illustrative app preview showing daily reminder settings for a habit.

Reminders on your terms

Set a daily nudge for each habit, right in your local time.

Illustrative previews of HabitMaker’s current home, habit calendar, and reminder settings.

Your own little garden

Up and growing in a few steps.

Run HabitMaker on your machine with Docker Compose. The stack includes the web app, API, and PostgreSQL database.

Before you begin

Install Docker with the Docker Compose plugin. Use a unique, random JWT_SECRET and a strong POSTGRES_PASSWORD in your .env file. To create an initial admin account, also set both ADMIN_EMAIL and ADMIN_PASSWORD.

Read the full setup guide

01
Install Docker
Get Docker Desktop or Docker Engine with the Docker Compose plugin.
02
Clone and configure
Clone the repository, copy the example environment file, then set your secrets.
```
git clone https://github.com/josesaranda/HabitMaker.git
cd HabitMaker
cp .env.example .env
```
03
Build and start
Build the images and run the app with its API and database.
```
docker compose up --build -d
```
04
Make it yours
Open the app and start shaping a routine that feels right for you.
```
http://localhost:8080
```

Good things grow together

Have an idea? There’s room to grow.

Try HabitMaker, report a bug, or help build the next small improvement. Contributions of every size are welcome.

Open an issue Submit a pull request

Not sure where to start? Browse the open issues or join the conversation.

Read the project README

Small habits.Meaningful change