HabitDeveloper

A behavior-intelligence app that uses on-device skip-pattern detection and Gollwitzer if-then prompts to make tomorrow easier than today.

Internal codename habit_tracker_pro. Product surface name is Invisible Habit Builder. Pre-alpha — not yet shipped.

Why this exists

92% of users abandon their habit tracker within 60 days (University of South Australia). The cause is universal across the category: streak fragility, decorative analytics, and 3-habit free walls. Every top-10 app makes the same three mistakes.

This app makes different ones.

• No streaks-as-shame. Skip-tolerant Lally math (persists if 12 of the last 14 days are completed). One miss never resets to zero. Backed by Lally et al. 2010 (single misses don't damage automaticity) and Duolingo's 21% churn reduction from streak-freeze tokens.
• Causal "why-skip" analytics. On-device clustering of skip patterns by day-of-week × time-of-day × context (HealthKit / Health Connect signals, calendar busyness, weather). Surfaces why you skip Tuesdays at 7pm, not just that you did.
• Implementation-intention prompts (Gollwitzer 1999, d=0.65). When the model predicts a high-skip-risk window, the app surfaces a pre-window prompt: "It looks like Tuesday evenings are hard. When dinner finishes Tuesday, then you'll [habit]?" — user fills the then. No major habit app productizes this.
• Identity-based completion (Clear 2018). "Today you cast 1 vote for runner." Not "checkbox done."
• Local-first, no account, "Data Not Collected" privacy nutrition label. Hive on-device storage; the only cross-device option is a user-driven export.
• One-time $6.99 lifetime IAP. No subscription. Streaks built a cult on $4.99 one-time. RevenueCat 2026 data: lifetime IAPs convert at 5–8% vs sub trials at 2.1% D35. Local-first means zero server cost to justify recurring revenue.

Full positioning + competitive analysis + reward-system design + build order: docs/BUILD_PLAN.md.

Tech

• Flutter 3.27.4 stable / Dart ^3.8.1
• Hive 2.2.3 (local key-value persistence — zero backend)
• Provider (state management)
• flutter_local_notifications 19.x with iOS .timeSensitive + Android USE_EXACT_ALARM for bulletproof reminders across iOS Focus Mode and Android 14+ Doze.
• purchases_flutter (RevenueCat) for $6.99 lifetime IAP + cross-platform receipt validation.
• health 13.x for HealthKit / Health Connect read + write-back so habit completions appear in the iOS Health app + Apple Watch rings.
• (v1.1) flutter_gemma on-device Gemma 3 1B for weekly reflection summaries and if-then prompt generation. Privacy-preserving AI never leaves the device.

Quickstart

git clone git@github.com:Outtsett/HabitDeveloper.git
cd HabitDeveloper
flutter pub get
dart run build_runner build --delete-conflicting-outputs
flutter run -d chrome   # web is fastest for UI iteration

Full setup, branching model, commit-message rules, and code conventions in CONTRIBUTING.md.

Status

Pre-alpha. The repo is a skeleton with several empty stub files — see the "Current state" table in CLAUDE.md for what's wired and what's still 0 bytes. No public release.

License

Proprietary — All Rights Reserved. Source-available for review only. No license is granted to use, copy, modify, or redistribute. See LICENSE for the full terms, including the contribution clause that governs pull requests and issues. Commercial / OEM / licensing inquiries: see Section 6 of LICENSE.

Security

See SECURITY.md. Don't open public issues for vulnerabilities.