Skip to content
CalculatorAI
AccueilFavorisHistorique
Handbook/Habit Tracker

On this page

  • Core Data Model
  • Cadence
  • Completion Rate
  • Streaks
  • Free And Pro Behavior
  • AI Assistant Context
  • Future Enhancements

Habit Tracker Methodology

CalculatorAI Habit Tracker is a lightweight routine tracker for users who want to see whether important habits are actually happening, without turning habit tracking into a second job.

The tracker focuses on three signals:

  • Today: which habits are due right now, with a quick check-in control.
  • Weekly consistency: how many scheduled habits were completed across the last seven days.
  • Streak quality: whether the user is building reliable momentum, not just chasing a vanity number.

Core Data Model

Each habit has a name, optional cue/description, icon, color, cadence and weekly target. A check-in is one completed habit on one calendar date.

The production tables are:

  • habit_tracker_habits
  • habit_tracker_checkins

Both tables are user-owned, protected by RLS, and use deleted_at soft-delete so user data is not hard-deleted from normal UI actions.

Cadence

The first release supports three simple cadence modes:

  • daily: the habit is expected every day.
  • weekdays: the habit is expected Monday through Friday.
  • custom: the habit is expected on the exact weekdays saved in selected_weekdays.

This keeps the product small and understandable while leaving room for later additions like reminders, negative habits, and habit groups.

Completion Rate

Weekly completion rate is calculated as:

completed check-ins in visible period / scheduled habit opportunities in visible period

If there are no active habits, the completion rate is zero.

Streaks

The initial streak model is intentionally strict: a day counts toward the all-habit streak only when every active habit scheduled for that day is complete.

This makes the streak meaningful, but the UI copy frames it as a signal rather than a punishment. The product should avoid shame-based language.

Free And Pro Behavior

Free users can create a small habit system. Pro users can create unlimited habits and keep a larger routine library.

Trial Pro and Paid Pro follow the standard platform Pro check: pro_until > now.

AI Assistant Context

When the site assistant reads Habit Tracker data, it should answer in a coaching style:

  • Identify which habits are consistent.
  • Identify which habits are slipping.
  • Suggest one small adjustment, not a long plan.
  • Avoid moralizing missed days.

Good answer:

Your strongest habit this week is Morning walk. Sleep by 11 slipped twice. I would keep the walk untouched and make the sleep habit easier: set the cutoff at 11:30 for one week, then tighten it.

Bad answer:

You failed your routine. You need more discipline.

Future Enhancements

Likely next iterations:

  • Specific weekdays for custom schedules.
  • Reminder notifications.
  • Habit groups such as Health, Work, Mindset and Money.
  • Notes per check-in.
  • AI weekly review.
  • Streak freeze / recovery rules.