Kadō

---

What is Kadō?

Kadō is an iOS habit tracker with three commitments:

1. A score, not a streak. The habit score — inspired by Loop Habit Tracker on Android — is a non-binary exponential moving average of your completions. One missed day doesn't wipe your progress. You see a trend, not a fragile chain.
2. Your data stays yours. No account, no analytics, no third-party SDKs. Storage is local (SwiftData), sync is optional through your own iCloud (CloudKit private database). Export is lossless, in JSON or CSV, whenever you want it. See PRIVACY.md.
3. Native to Apple. SwiftUI, @Observable, SwiftData, CloudKit, WidgetKit, App Intents — no cross-platform layer, no third-party dependencies.

Why another habit tracker? The market gap is spelled out in docs/PRODUCT.md: the reference open-source tracker (Loop) is Android-only; the reference iOS tracker (Streaks) is closed source and uses a binary streak; the most visible modern iOS open source attempt (Teymia) is freemium. Kadō takes Loop's algorithm to native iOS — MIT, free, no account, no subscription.

Screenshots

iPhone and iPhone Duo

iPad — the habit list and the habit you pick, side by side

Features

• Today view — habits due today, tap to complete, long-press for partial / note / timer, drag to reorder (the order syncs via iCloud). Counter and timer rows show the day's total between − and +, with a haptic tick on every tap; "Log specific value…" opens a number pad with today's value selected. Finish the day and Kadō throws confetti (just a caption under Reduce Motion).
• Habit detail — monthly calendar with month-by-month navigation, current streak, best streak, habit score with an info popover explaining the math. Edit any past day straight from the calendar, including days before the habit existed (the calendar says when that makes it the new start date). Long-press a History entry to delete it.
• Side by side on iPad and iPhone Duo — in regular width, Today shows the habit list and the habit you pick next to each other: score, streak, calendar and history beside the list, which keeps logging. On iPhone Duo that's the unfolded layout; folded, it's the iPhone app.
• Per-day notes — a short note on any day's completion, carried through export and import.
• Overview — habits × days matrix with score-shaded cells, the Loop / Way of Life pattern with Kadō's score DNA. Tap a day to mark a habit completed right from the popover. Completions logged off-schedule show up too, instead of hiding as rest days.
• Flexible schedules — daily, N days per week, specific weekdays, every N days (the cycle re-anchors on each completion, so finishing early never costs you a day). Binary, counter, or timer habit types.
• Day starts at — move the day rollover to any hour, so late-night logging (or a night-shift schedule) lands on the day you mean. Changing it never re-buckets history.
• Week starts where you do — calendars and week grids follow your region's first day of the week, or the one you pick in Settings.
• Archived habits — Settings lists them; unarchive one with its history intact, or delete it for good.
• Widgets — Home Screen (small / medium / large), each showing the habits you pick in Edit Widget (up to 5 or 8, in your order), and Lock Screen (rectangular / circular / inline, plus a Daily Progress ring). Quick-complete via AppIntent; widgets roll over to the new day on their own and stay legible under the Clear and Tinted Home Screen appearances.
• Siri and Shortcuts — complete a habit, log a value, or ask for a score and streak, hands-free. Also available as Home Screen actions and Shortcuts automations.
• Reminders — per-habit local notifications with recurring schedules and check / skip quick actions.
• iCloud sync — optional, opt-in, goes only through the user's private CloudKit database. Settings shows live sync state, including when sync isn't working.
• JSON and CSV export / import — lossless backup of your data, in both formats, round-trip tested. Open a CSV backup in Numbers or Excel, edit it, bring it back in.
• Appearance — choose the colours your habits wear: Kadō or Classic for free, and four more palettes (Muted, Vivid, Autumn, Monochrome sage) plus seven alternate app icons with the Supporter pack. Widgets follow the palette.
• Supporter pack and Tip Jar — a one-time, Family Sharing-enabled purchase that unlocks the extra palettes and icons, and a Tip Jar that unlocks nothing. Both are optional: every feature that tracks a habit stays free, with no ads, no subscription, and no tracking.
• Accessibility — Dynamic Type up to XXXL, VoiceOver labels on every surface, full Dark Mode.
• Localization — English and native French (not machine-translated).

Status

Shipping on the App Store — current version 1.14.

This is the beginning of the README. Read the rest at the original. Read the full README ↗