Every score in Notion Habit Heroes comes from checkboxes you actually ticked in your Notion database. Streaks count consecutive days you completed your tracked habits. Points are a running total of completed habits. A leaderboard ranks who has been showing up. There is no mechanism to inflate any of these numbers: the only way to move them is to do the habit and check the box. The game layer is real behavior data, looked at from a different angle.
The mechanics that earn their place
Four things make up the game layer, all reading from the same checkbox data.
Streaks count consecutive days on which you completed your tracked habits. They work through loss aversion: a twelve-day streak is something you have already earned and do not want to lose, which is a more reliable daily motivator than the vague intention to keep going. Losing a long streak is the deflating moment in any tracker, so the widget (the live scoreboard you can embed on any Notion page) reframes it: each habit badge shows your current streak against your personal best, and when a streak breaks, the bar resets and starts filling toward your previous record. Two days against a best of nine reads as a comeback in progress, and beating your own record is a competition you carry even before any friends join. The post on making habits feel like a game covers the underlying mechanism in more detail.
Points accumulate across every completed habit, and a day where every due habit lands is recorded as a perfect day. Accumulation creates visible progress even on days where no single habit feels significant on its own.
Leaderboards and 1-on-1 duels introduce social comparison: your points stand next to a friend's in a shared challenge, or against a single opponent in a duel. Both add a kind of accountability that solo tracking cannot reach, which is the whole case for tracking habits with friends in the first place.
Insights let you see whether progress is real. Sparklines and previous-period comparisons surface trends against data you can inspect, not just sense.
Real data keeps the score honest
Every night, at local midnight in your timezone, the sync engine reads the checkboxes in your Notion database and updates your records. If you have friends in different timezones, each person's data settles at their own local midnight, so the rules are consistent regardless of where anyone lives.
Streaks reset when you actually miss a day. Points count habits you completed. Numbers that track real behavior stay meaningful, and meaningful numbers are the ones people keep checking. The honesty extends to the parts you might prefer not to see: every habit badge flips over to reveal that habit's all-time completion rate and total completions. A 20 percent completion rate is an uncomfortable number, and it is precisely because the widget will show you that number that the good ones count for something.
A scoreboard built this way is one you can trust. When a friend's total climbs faster than yours, you know they put in more completed habits. When your streak climbs, you know you showed up. The numbers reflect the work, which is the only reason to look at them in the first place.
Where the hero theme lives: the artwork
Notion Habit Heroes takes its name and visual identity from RPG mythology. The hero theme lives in the artwork: hand-drawn illustrations appear across the product, including a tavern scene that frames paused streaks, a podium backdrop for competition results, and illustrated backgrounds behind the streak and leaderboard widgets. Each illustration sits behind live data under a translucent overlay that keeps the numbers readable. Theme is flavor; data is substance.
The app started as a bridge that synced Notion checkboxes into Habitica, but running two separate systems in parallel created more friction than it solved. Building the game layer directly around the checkboxes was the obvious answer. The full story is at the story behind Notion Habit Heroes.
Turning your Notion database into the game board
The setup takes a few minutes. Connect your existing Notion habit database through the official Notion OAuth flow, or duplicate our free Notion habit tracker template if you are starting from scratch. After connecting, you confirm which checkbox properties count as tracked habits in the widget; no formula work required.
From that point, your checkboxes sync every night in your local timezone. Streaks, points, and completion rates update overnight without any action from you. A self-healing pass in the early hours covers any sync that was missed.
Once streaks and points are running, the embeddable widget lets you place live stats directly on any Notion page, so the numbers sit beside the checkboxes where you make your daily decisions. When you want to bring in other people, you can start a group competition with a shared leaderboard or challenge a specific friend to a 1-on-1 duel. The full mechanics of competitions and duels are covered in the habit competitions post.
Getting started
The free plan covers everything: nightly sync, streaks, points, the embeddable widget, competitions, leaderboards, duels and insights, all included with no paid tier. Create a free account and connect your Notion habit database to start. For a full walkthrough of how everything connects, see how it works.