Don't Drink

Small daily choices. Big long-term changes.

A mobile app that helps you reduce or eliminate alcohol consumption through daily tracking, streaks, achievements, education, and motivation.

Features

Daily Tracker

Log exactly one status per day by tapping any date. Five levels:

Status	Color	Meaning
No Drinks	Green	0 alcoholic drinks
1–2 Drinks	Yellow	Light drinking
3–5 Drinks	Orange	Moderate drinking
6+ Drinks	Red	Heavy drinking
Blackout	Black	Extreme drinking / memory loss

You can edit any past day. Future days are disabled.

Streak Counter

The dashboard shows your current alcohol-free streak and your all-time longest streak. If today hasn't been logged yet, the streak is measured through yesterday so the counter doesn't reset just from not opening the app.

Color-Coded Calendar

Browse any month's color-coded grid. Navigate backward month by month. Tap any day to log or edit it.

Achievement System

Nine streak milestones unlock automatically — based on your longest ever streak, so a relapse doesn't erase a badge. Legendary milestones fire a confetti celebration.

Day	Achievement
1	Better Liver Begins
3	Better Hydration
7	Better Sleep
14	More Energy
30	One Month Strong ⭐
60	Mental Clarity
90	New Lifestyle ⭐
180	Half-Year Champion ⭐
365	One Year Alcohol-Free ⭐

Statistics

Bar chart of alcohol-free days over the last 6 months, a pie chart of drink-level distribution, and a headline overview (longest streak, free-day rate, best month).

Recovery Timeline

A milestone timeline showing what the body gains hour-by-hour and month-by-month when alcohol-free — with your current streak highlighted as "reached."

Facts & Education

A daily rotating fact card plus browsable lists of alcohol harms and benefits of not drinking.

Motivation

Swipeable full-bleed motivation cards. Tap Inspire me to jump to a random one.

Daily Reminder (optional)

An on-device scheduled notification at a time you choose (default 8:00 PM). Can be toggled off at any time. Requires notification permission.

Theme

Light, dark, or system-default — switchable in Settings.

Architecture

lib/
├── core/
│ ├── models/ # DrinkLevel, DayEntry, Achievement
│ ├── theme/ # AppTheme (Material 3), AppColors
│ └── utils/ # DateOnly helpers
├── data/
│ ├── database/ # AppDatabase (SQLite via sqflite)
│ ├── repositories/ # EntryRepository, SettingsRepository
│ └── static/ # Achievements, facts, recovery, motivation
├── services/ # StatsService, AchievementService, NotificationService
├── viewmodels/ # TrackerViewModel, SettingsViewModel (ChangeNotifier / Provider)
└── ui/
├── dashboard/
├── calendar/
├── achievements/
├── statistics/
├── recovery/
├── facts/
├── motivation/
├── settings/
├── more/
├── shell/ # HomeShell (NavigationBar)
└── widgets/ # AppCard, DayEntrySheet, AchievementUnlockDialog, ...

Pattern: MVVM. ViewModels extend ChangeNotifier and are provided via provider. Screens read from ViewModels and call ViewModel methods; they do not touch the database directly. All data is local (SQLite + SharedPreferences).

Building

Prerequisites

Tool	Version
Flutter (via fvm)	3.41.2 stable
Dart	3.11.0
Android SDK	at `~/Android/Sdk`
Android NDK	28.2 (installed in `~/Android/Sdk/ndk/`)
Java	17+

Flutter is managed by fvm. The project's .fvm/ config pins the version automatically.

Note — SDK path:android/local.properties points at ~/Android/Sdk. If Flutter rewrites it back to /opt/android-sdk during pub get, change sdk.dir back to /home/ben/Android/Sdk. The /opt SDK has no NDK and no accepted licenses.

Run the app

# With fvm on PATH (or use the full path):
flutter pub get
flutter run

Build a debug APK

flutter build apk --debug
# Output: build/app/outputs/flutter-apk/app-debug.apk

Build a release APK

flutter build apk --release

Run tests

flutter test

Covers streak calculation, longest-streak detection, monthly aggregation, and stats computation (7 unit tests in test/stats_service_test.dart).

Static analysis

flutter analyze
# Expected: No issues found

Android Manifest Notes

The app declares POST_NOTIFICATIONS and RECEIVE_BOOT_COMPLETED permissions for the optional daily reminder. No network permission is declared — the app is fully offline.

Dependencies

Package	Purpose
`provider`	MVVM state management
`sqflite`	Local SQLite database
`shared_preferences`	Theme + notification preferences
`fl_chart`	Statistics charts
`confetti`	Achievement milestone celebrations
`flutter_local_notifications`	Optional daily reminder
`timezone`	Reliable local-time scheduling
`intl`	Date formatting
`google_fonts`	Inter typeface
`path`	Database path construction

Don't Drink

Small daily choices. Big long-term changes.

A mobile app that helps you reduce or eliminate alcohol consumption through daily tracking, streaks, achievements, education, and motivation.

Features

Daily Tracker

Log exactly one status per day by tapping any date. Five levels:

Status	Color	Meaning
No Drinks	Green	0 alcoholic drinks
1–2 Drinks	Yellow	Light drinking
3–5 Drinks	Orange	Moderate drinking
6+ Drinks	Red	Heavy drinking
Blackout	Black	Extreme drinking / memory loss

You can edit any past day. Future days are disabled.

Streak Counter

The dashboard shows your current alcohol-free streak and your all-time longest streak. If today hasn't been logged yet, the streak is measured through yesterday so the counter doesn't reset just from not opening the app.

Color-Coded Calendar

Browse any month's color-coded grid. Navigate backward month by month. Tap any day to log or edit it.

Achievement System

Nine streak milestones unlock automatically — based on your longest ever streak, so a relapse doesn't erase a badge. Legendary milestones fire a confetti celebration.

Day	Achievement
1	Better Liver Begins
3	Better Hydration
7	Better Sleep
14	More Energy
30	One Month Strong ⭐
60	Mental Clarity
90	New Lifestyle ⭐
180	Half-Year Champion ⭐
365	One Year Alcohol-Free ⭐

Statistics

Bar chart of alcohol-free days over the last 6 months, a pie chart of drink-level distribution, and a headline overview (longest streak, free-day rate, best month).

Recovery Timeline

A milestone timeline showing what the body gains hour-by-hour and month-by-month when alcohol-free — with your current streak highlighted as "reached."

Facts & Education

A daily rotating fact card plus browsable lists of alcohol harms and benefits of not drinking.

Motivation

Swipeable full-bleed motivation cards. Tap Inspire me to jump to a random one.

Daily Reminder (optional)

An on-device scheduled notification at a time you choose (default 8:00 PM). Can be toggled off at any time. Requires notification permission.

Theme

Light, dark, or system-default — switchable in Settings.

Architecture

lib/
├── core/
│ ├── models/ # DrinkLevel, DayEntry, Achievement
│ ├── theme/ # AppTheme (Material 3), AppColors
│ └── utils/ # DateOnly helpers
├── data/
│ ├── database/ # AppDatabase (SQLite via sqflite)
│ ├── repositories/ # EntryRepository, SettingsRepository
│ └── static/ # Achievements, facts, recovery, motivation
├── services/ # StatsService, AchievementService, NotificationService
├── viewmodels/ # TrackerViewModel, SettingsViewModel (ChangeNotifier / Provider)
└── ui/
├── dashboard/
├── calendar/
├── achievements/
├── statistics/
├── recovery/
├── facts/
├── motivation/
├── settings/
├── more/
├── shell/ # HomeShell (NavigationBar)
└── widgets/ # AppCard, DayEntrySheet, AchievementUnlockDialog, ...

Pattern: MVVM. ViewModels extend ChangeNotifier and are provided via provider. Screens read from ViewModels and call ViewModel methods; they do not touch the database directly. All data is local (SQLite + SharedPreferences).

Building

Prerequisites

Tool	Version
Flutter (via fvm)	3.41.2 stable
Dart	3.11.0
Android SDK	at `~/Android/Sdk`
Android NDK	28.2 (installed in `~/Android/Sdk/ndk/`)
Java	17+

Flutter is managed by fvm. The project's .fvm/ config pins the version automatically.

Note — SDK path:android/local.properties points at ~/Android/Sdk. If Flutter rewrites it back to /opt/android-sdk during pub get, change sdk.dir back to /home/ben/Android/Sdk. The /opt SDK has no NDK and no accepted licenses.

Run the app

# With fvm on PATH (or use the full path):
flutter pub get
flutter run

Build a debug APK

flutter build apk --debug
# Output: build/app/outputs/flutter-apk/app-debug.apk

Build a release APK

flutter build apk --release

Run tests

flutter test

Covers streak calculation, longest-streak detection, monthly aggregation, and stats computation (7 unit tests in test/stats_service_test.dart).

Static analysis

flutter analyze
# Expected: No issues found

Android Manifest Notes

The app declares POST_NOTIFICATIONS and RECEIVE_BOOT_COMPLETED permissions for the optional daily reminder. No network permission is declared — the app is fully offline.

Dependencies

Package	Purpose
`provider`	MVVM state management
`sqflite`	Local SQLite database
`shared_preferences`	Theme + notification preferences
`fl_chart`	Statistics charts
`confetti`	Achievement milestone celebrations
`flutter_local_notifications`	Optional daily reminder
`timezone`	Reliable local-time scheduling
`intl`	Date formatting
`google_fonts`	Inter typeface
`path`	Database path construction

Don't Drink

Small daily choices. Big long-term changes.

A mobile app that helps you reduce or eliminate alcohol consumption through daily tracking, streaks, achievements, education, and motivation.

Features

Daily Tracker

Log exactly one status per day by tapping any date. Five levels:

Status	Color	Meaning
No Drinks	Green	0 alcoholic drinks
1–2 Drinks	Yellow	Light drinking
3–5 Drinks	Orange	Moderate drinking
6+ Drinks	Red	Heavy drinking
Blackout	Black	Extreme drinking / memory loss

You can edit any past day. Future days are disabled.

Streak Counter

The dashboard shows your current alcohol-free streak and your all-time longest streak. If today hasn't been logged yet, the streak is measured through yesterday so the counter doesn't reset just from not opening the app.

Color-Coded Calendar

Browse any month's color-coded grid. Navigate backward month by month. Tap any day to log or edit it.

Achievement System

Nine streak milestones unlock automatically — based on your longest ever streak, so a relapse doesn't erase a badge. Legendary milestones fire a confetti celebration.

Day	Achievement
1	Better Liver Begins
3	Better Hydration
7	Better Sleep
14	More Energy
30	One Month Strong ⭐
60	Mental Clarity
90	New Lifestyle ⭐
180	Half-Year Champion ⭐
365	One Year Alcohol-Free ⭐

Statistics

Bar chart of alcohol-free days over the last 6 months, a pie chart of drink-level distribution, and a headline overview (longest streak, free-day rate, best month).

Recovery Timeline

A milestone timeline showing what the body gains hour-by-hour and month-by-month when alcohol-free — with your current streak highlighted as "reached."

Facts & Education

A daily rotating fact card plus browsable lists of alcohol harms and benefits of not drinking.

Motivation

Swipeable full-bleed motivation cards. Tap Inspire me to jump to a random one.

Daily Reminder (optional)

An on-device scheduled notification at a time you choose (default 8:00 PM). Can be toggled off at any time. Requires notification permission.

Theme

Light, dark, or system-default — switchable in Settings.

Architecture

lib/
├── core/
│ ├── models/ # DrinkLevel, DayEntry, Achievement
│ ├── theme/ # AppTheme (Material 3), AppColors
│ └── utils/ # DateOnly helpers
├── data/
│ ├── database/ # AppDatabase (SQLite via sqflite)
│ ├── repositories/ # EntryRepository, SettingsRepository
│ └── static/ # Achievements, facts, recovery, motivation
├── services/ # StatsService, AchievementService, NotificationService
├── viewmodels/ # TrackerViewModel, SettingsViewModel (ChangeNotifier / Provider)
└── ui/
├── dashboard/
├── calendar/
├── achievements/
├── statistics/
├── recovery/
├── facts/
├── motivation/
├── settings/
├── more/
├── shell/ # HomeShell (NavigationBar)
└── widgets/ # AppCard, DayEntrySheet, AchievementUnlockDialog, ...

Pattern: MVVM. ViewModels extend ChangeNotifier and are provided via provider. Screens read from ViewModels and call ViewModel methods; they do not touch the database directly. All data is local (SQLite + SharedPreferences).

Building

Prerequisites

Tool	Version
Flutter (via fvm)	3.41.2 stable
Dart	3.11.0
Android SDK	at `~/Android/Sdk`
Android NDK	28.2 (installed in `~/Android/Sdk/ndk/`)
Java	17+

Flutter is managed by fvm. The project's .fvm/ config pins the version automatically.

Note — SDK path:android/local.properties points at ~/Android/Sdk. If Flutter rewrites it back to /opt/android-sdk during pub get, change sdk.dir back to /home/ben/Android/Sdk. The /opt SDK has no NDK and no accepted licenses.

Run the app

# With fvm on PATH (or use the full path):
flutter pub get
flutter run

Build a debug APK

flutter build apk --debug
# Output: build/app/outputs/flutter-apk/app-debug.apk

Build a release APK

flutter build apk --release

Run tests

flutter test

Covers streak calculation, longest-streak detection, monthly aggregation, and stats computation (7 unit tests in test/stats_service_test.dart).

Static analysis

flutter analyze
# Expected: No issues found

Android Manifest Notes

The app declares POST_NOTIFICATIONS and RECEIVE_BOOT_COMPLETED permissions for the optional daily reminder. No network permission is declared — the app is fully offline.

Dependencies

Package	Purpose
`provider`	MVVM state management
`sqflite`	Local SQLite database
`shared_preferences`	Theme + notification preferences
`fl_chart`	Statistics charts
`confetti`	Achievement milestone celebrations
`flutter_local_notifications`	Optional daily reminder
`timezone`	Reliable local-time scheduling
`intl`	Date formatting
`google_fonts`	Inter typeface
`path`	Database path construction

Don't Drink

Small daily choices. Big long-term changes.

A mobile app that helps you reduce or eliminate alcohol consumption through daily tracking, streaks, achievements, education, and motivation.

Features

Daily Tracker

Log exactly one status per day by tapping any date. Five levels:

Status	Color	Meaning
No Drinks	Green	0 alcoholic drinks
1–2 Drinks	Yellow	Light drinking
3–5 Drinks	Orange	Moderate drinking
6+ Drinks	Red	Heavy drinking
Blackout	Black	Extreme drinking / memory loss

You can edit any past day. Future days are disabled.

Streak Counter

The dashboard shows your current alcohol-free streak and your all-time longest streak. If today hasn't been logged yet, the streak is measured through yesterday so the counter doesn't reset just from not opening the app.

Color-Coded Calendar

Browse any month's color-coded grid. Navigate backward month by month. Tap any day to log or edit it.

Achievement System

Nine streak milestones unlock automatically — based on your longest ever streak, so a relapse doesn't erase a badge. Legendary milestones fire a confetti celebration.

Day	Achievement
1	Better Liver Begins
3	Better Hydration
7	Better Sleep
14	More Energy
30	One Month Strong ⭐
60	Mental Clarity
90	New Lifestyle ⭐
180	Half-Year Champion ⭐
365	One Year Alcohol-Free ⭐

Statistics

Bar chart of alcohol-free days over the last 6 months, a pie chart of drink-level distribution, and a headline overview (longest streak, free-day rate, best month).

Recovery Timeline

A milestone timeline showing what the body gains hour-by-hour and month-by-month when alcohol-free — with your current streak highlighted as "reached."

Facts & Education

A daily rotating fact card plus browsable lists of alcohol harms and benefits of not drinking.

Motivation

Swipeable full-bleed motivation cards. Tap Inspire me to jump to a random one.

Daily Reminder (optional)

An on-device scheduled notification at a time you choose (default 8:00 PM). Can be toggled off at any time. Requires notification permission.

Theme

Light, dark, or system-default — switchable in Settings.

Architecture

lib/
├── core/
│ ├── models/ # DrinkLevel, DayEntry, Achievement
│ ├── theme/ # AppTheme (Material 3), AppColors
│ └── utils/ # DateOnly helpers
├── data/
│ ├── database/ # AppDatabase (SQLite via sqflite)
│ ├── repositories/ # EntryRepository, SettingsRepository
│ └── static/ # Achievements, facts, recovery, motivation
├── services/ # StatsService, AchievementService, NotificationService
├── viewmodels/ # TrackerViewModel, SettingsViewModel (ChangeNotifier / Provider)
└── ui/
├── dashboard/
├── calendar/
├── achievements/
├── statistics/
├── recovery/
├── facts/
├── motivation/
├── settings/
├── more/
├── shell/ # HomeShell (NavigationBar)
└── widgets/ # AppCard, DayEntrySheet, AchievementUnlockDialog, ...

Pattern: MVVM. ViewModels extend ChangeNotifier and are provided via provider. Screens read from ViewModels and call ViewModel methods; they do not touch the database directly. All data is local (SQLite + SharedPreferences).

Building

Prerequisites

Tool	Version
Flutter (via fvm)	3.41.2 stable
Dart	3.11.0
Android SDK	at `~/Android/Sdk`
Android NDK	28.2 (installed in `~/Android/Sdk/ndk/`)
Java	17+

Flutter is managed by fvm. The project's .fvm/ config pins the version automatically.

Note — SDK path:android/local.properties points at ~/Android/Sdk. If Flutter rewrites it back to /opt/android-sdk during pub get, change sdk.dir back to /home/ben/Android/Sdk. The /opt SDK has no NDK and no accepted licenses.

Run the app

# With fvm on PATH (or use the full path):
flutter pub get
flutter run

Build a debug APK

flutter build apk --debug
# Output: build/app/outputs/flutter-apk/app-debug.apk

Build a release APK

flutter build apk --release

Run tests

flutter test

Covers streak calculation, longest-streak detection, monthly aggregation, and stats computation (7 unit tests in test/stats_service_test.dart).

Static analysis

flutter analyze
# Expected: No issues found

Android Manifest Notes

The app declares POST_NOTIFICATIONS and RECEIVE_BOOT_COMPLETED permissions for the optional daily reminder. No network permission is declared — the app is fully offline.

Dependencies

Package	Purpose
`provider`	MVVM state management
`sqflite`	Local SQLite database
`shared_preferences`	Theme + notification preferences
`fl_chart`	Statistics charts
`confetti`	Achievement milestone celebrations
`flutter_local_notifications`	Optional daily reminder
`timezone`	Reliable local-time scheduling
`intl`	Date formatting
`google_fonts`	Inter typeface
`path`	Database path construction

Don't Drink

Small daily choices. Big long-term changes.

A mobile app that helps you reduce or eliminate alcohol consumption through daily tracking, streaks, achievements, education, and motivation.

Features

Daily Tracker

Log exactly one status per day by tapping any date. Five levels:

Status	Color	Meaning
No Drinks	Green	0 alcoholic drinks
1–2 Drinks	Yellow	Light drinking
3–5 Drinks	Orange	Moderate drinking
6+ Drinks	Red	Heavy drinking
Blackout	Black	Extreme drinking / memory loss

You can edit any past day. Future days are disabled.

Streak Counter

The dashboard shows your current alcohol-free streak and your all-time longest streak. If today hasn't been logged yet, the streak is measured through yesterday so the counter doesn't reset just from not opening the app.

Color-Coded Calendar

Browse any month's color-coded grid. Navigate backward month by month. Tap any day to log or edit it.

Achievement System

Nine streak milestones unlock automatically — based on your longest ever streak, so a relapse doesn't erase a badge. Legendary milestones fire a confetti celebration.

Day	Achievement
1	Better Liver Begins
3	Better Hydration
7	Better Sleep
14	More Energy
30	One Month Strong ⭐
60	Mental Clarity
90	New Lifestyle ⭐
180	Half-Year Champion ⭐
365	One Year Alcohol-Free ⭐

Statistics

Bar chart of alcohol-free days over the last 6 months, a pie chart of drink-level distribution, and a headline overview (longest streak, free-day rate, best month).

Recovery Timeline

A milestone timeline showing what the body gains hour-by-hour and month-by-month when alcohol-free — with your current streak highlighted as "reached."

Facts & Education

A daily rotating fact card plus browsable lists of alcohol harms and benefits of not drinking.

Motivation

Swipeable full-bleed motivation cards. Tap Inspire me to jump to a random one.

Daily Reminder (optional)

An on-device scheduled notification at a time you choose (default 8:00 PM). Can be toggled off at any time. Requires notification permission.

Theme

Light, dark, or system-default — switchable in Settings.

Architecture

lib/
├── core/
│ ├── models/ # DrinkLevel, DayEntry, Achievement
│ ├── theme/ # AppTheme (Material 3), AppColors
│ └── utils/ # DateOnly helpers
├── data/
│ ├── database/ # AppDatabase (SQLite via sqflite)
│ ├── repositories/ # EntryRepository, SettingsRepository
│ └── static/ # Achievements, facts, recovery, motivation
├── services/ # StatsService, AchievementService, NotificationService
├── viewmodels/ # TrackerViewModel, SettingsViewModel (ChangeNotifier / Provider)
└── ui/
├── dashboard/
├── calendar/
├── achievements/
├── statistics/
├── recovery/
├── facts/
├── motivation/
├── settings/
├── more/
├── shell/ # HomeShell (NavigationBar)
└── widgets/ # AppCard, DayEntrySheet, AchievementUnlockDialog, ...

Pattern: MVVM. ViewModels extend ChangeNotifier and are provided via provider. Screens read from ViewModels and call ViewModel methods; they do not touch the database directly. All data is local (SQLite + SharedPreferences).

Building

Prerequisites

Tool	Version
Flutter (via fvm)	3.41.2 stable
Dart	3.11.0
Android SDK	at `~/Android/Sdk`
Android NDK	28.2 (installed in `~/Android/Sdk/ndk/`)
Java	17+

Flutter is managed by fvm. The project's .fvm/ config pins the version automatically.

Note — SDK path:android/local.properties points at ~/Android/Sdk. If Flutter rewrites it back to /opt/android-sdk during pub get, change sdk.dir back to /home/ben/Android/Sdk. The /opt SDK has no NDK and no accepted licenses.

Run the app

# With fvm on PATH (or use the full path):
flutter pub get
flutter run

Build a debug APK

flutter build apk --debug
# Output: build/app/outputs/flutter-apk/app-debug.apk

Build a release APK

flutter build apk --release

Run tests

flutter test

Covers streak calculation, longest-streak detection, monthly aggregation, and stats computation (7 unit tests in test/stats_service_test.dart).

Static analysis

flutter analyze
# Expected: No issues found

Android Manifest Notes

The app declares POST_NOTIFICATIONS and RECEIVE_BOOT_COMPLETED permissions for the optional daily reminder. No network permission is declared — the app is fully offline.

Dependencies

Package	Purpose
`provider`	MVVM state management
`sqflite`	Local SQLite database
`shared_preferences`	Theme + notification preferences
`fl_chart`	Statistics charts
`confetti`	Achievement milestone celebrations
`flutter_local_notifications`	Optional daily reminder
`timezone`	Reliable local-time scheduling
`intl`	Date formatting
`google_fonts`	Inter typeface
`path`	Database path construction

Don't Drink

Small daily choices. Big long-term changes.

A mobile app that helps you reduce or eliminate alcohol consumption through daily tracking, streaks, achievements, education, and motivation.

Features

Daily Tracker

Log exactly one status per day by tapping any date. Five levels:

Status	Color	Meaning
No Drinks	Green	0 alcoholic drinks
1–2 Drinks	Yellow	Light drinking
3–5 Drinks	Orange	Moderate drinking
6+ Drinks	Red	Heavy drinking
Blackout	Black	Extreme drinking / memory loss

You can edit any past day. Future days are disabled.

Streak Counter

The dashboard shows your current alcohol-free streak and your all-time longest streak. If today hasn't been logged yet, the streak is measured through yesterday so the counter doesn't reset just from not opening the app.

Color-Coded Calendar

Browse any month's color-coded grid. Navigate backward month by month. Tap any day to log or edit it.

Achievement System

Nine streak milestones unlock automatically — based on your longest ever streak, so a relapse doesn't erase a badge. Legendary milestones fire a confetti celebration.

Day	Achievement
1	Better Liver Begins
3	Better Hydration
7	Better Sleep
14	More Energy
30	One Month Strong ⭐
60	Mental Clarity
90	New Lifestyle ⭐
180	Half-Year Champion ⭐
365	One Year Alcohol-Free ⭐

Statistics

Bar chart of alcohol-free days over the last 6 months, a pie chart of drink-level distribution, and a headline overview (longest streak, free-day rate, best month).

Recovery Timeline

A milestone timeline showing what the body gains hour-by-hour and month-by-month when alcohol-free — with your current streak highlighted as "reached."

Facts & Education

A daily rotating fact card plus browsable lists of alcohol harms and benefits of not drinking.

Motivation

Swipeable full-bleed motivation cards. Tap Inspire me to jump to a random one.

Daily Reminder (optional)

An on-device scheduled notification at a time you choose (default 8:00 PM). Can be toggled off at any time. Requires notification permission.

Theme

Light, dark, or system-default — switchable in Settings.

Architecture

lib/
├── core/
│ ├── models/ # DrinkLevel, DayEntry, Achievement
│ ├── theme/ # AppTheme (Material 3), AppColors
│ └── utils/ # DateOnly helpers
├── data/
│ ├── database/ # AppDatabase (SQLite via sqflite)
│ ├── repositories/ # EntryRepository, SettingsRepository
│ └── static/ # Achievements, facts, recovery, motivation
├── services/ # StatsService, AchievementService, NotificationService
├── viewmodels/ # TrackerViewModel, SettingsViewModel (ChangeNotifier / Provider)
└── ui/
├── dashboard/
├── calendar/
├── achievements/
├── statistics/
├── recovery/
├── facts/
├── motivation/
├── settings/
├── more/
├── shell/ # HomeShell (NavigationBar)
└── widgets/ # AppCard, DayEntrySheet, AchievementUnlockDialog, ...

Pattern: MVVM. ViewModels extend ChangeNotifier and are provided via provider. Screens read from ViewModels and call ViewModel methods; they do not touch the database directly. All data is local (SQLite + SharedPreferences).

Building

Prerequisites

Tool	Version
Flutter (via fvm)	3.41.2 stable
Dart	3.11.0
Android SDK	at `~/Android/Sdk`
Android NDK	28.2 (installed in `~/Android/Sdk/ndk/`)
Java	17+

Flutter is managed by fvm. The project's .fvm/ config pins the version automatically.

Note — SDK path:android/local.properties points at ~/Android/Sdk. If Flutter rewrites it back to /opt/android-sdk during pub get, change sdk.dir back to /home/ben/Android/Sdk. The /opt SDK has no NDK and no accepted licenses.

Run the app

# With fvm on PATH (or use the full path):
flutter pub get
flutter run

Build a debug APK

flutter build apk --debug
# Output: build/app/outputs/flutter-apk/app-debug.apk

Build a release APK

flutter build apk --release

Run tests

flutter test

Covers streak calculation, longest-streak detection, monthly aggregation, and stats computation (7 unit tests in test/stats_service_test.dart).

Static analysis

flutter analyze
# Expected: No issues found

Android Manifest Notes

The app declares POST_NOTIFICATIONS and RECEIVE_BOOT_COMPLETED permissions for the optional daily reminder. No network permission is declared — the app is fully offline.

Dependencies

Package	Purpose
`provider`	MVVM state management
`sqflite`	Local SQLite database
`shared_preferences`	Theme + notification preferences
`fl_chart`	Statistics charts
`confetti`	Achievement milestone celebrations
`flutter_local_notifications`	Optional daily reminder
`timezone`	Reliable local-time scheduling
`intl`	Date formatting
`google_fonts`	Inter typeface
`path`	Database path construction

Don't Drink

Small daily choices. Big long-term changes.

A mobile app that helps you reduce or eliminate alcohol consumption through daily tracking, streaks, achievements, education, and motivation.

Features

Daily Tracker

Log exactly one status per day by tapping any date. Five levels:

Status	Color	Meaning
No Drinks	Green	0 alcoholic drinks
1–2 Drinks	Yellow	Light drinking
3–5 Drinks	Orange	Moderate drinking
6+ Drinks	Red	Heavy drinking
Blackout	Black	Extreme drinking / memory loss

You can edit any past day. Future days are disabled.

Streak Counter

The dashboard shows your current alcohol-free streak and your all-time longest streak. If today hasn't been logged yet, the streak is measured through yesterday so the counter doesn't reset just from not opening the app.

Color-Coded Calendar

Browse any month's color-coded grid. Navigate backward month by month. Tap any day to log or edit it.

Achievement System

Nine streak milestones unlock automatically — based on your longest ever streak, so a relapse doesn't erase a badge. Legendary milestones fire a confetti celebration.

Day	Achievement
1	Better Liver Begins
3	Better Hydration
7	Better Sleep
14	More Energy
30	One Month Strong ⭐
60	Mental Clarity
90	New Lifestyle ⭐
180	Half-Year Champion ⭐
365	One Year Alcohol-Free ⭐

Statistics

Bar chart of alcohol-free days over the last 6 months, a pie chart of drink-level distribution, and a headline overview (longest streak, free-day rate, best month).

Recovery Timeline

A milestone timeline showing what the body gains hour-by-hour and month-by-month when alcohol-free — with your current streak highlighted as "reached."

Facts & Education

A daily rotating fact card plus browsable lists of alcohol harms and benefits of not drinking.

Motivation

Swipeable full-bleed motivation cards. Tap Inspire me to jump to a random one.

Daily Reminder (optional)

An on-device scheduled notification at a time you choose (default 8:00 PM). Can be toggled off at any time. Requires notification permission.

Theme

Light, dark, or system-default — switchable in Settings.

Architecture

lib/
├── core/
│ ├── models/ # DrinkLevel, DayEntry, Achievement
│ ├── theme/ # AppTheme (Material 3), AppColors
│ └── utils/ # DateOnly helpers
├── data/
│ ├── database/ # AppDatabase (SQLite via sqflite)
│ ├── repositories/ # EntryRepository, SettingsRepository
│ └── static/ # Achievements, facts, recovery, motivation
├── services/ # StatsService, AchievementService, NotificationService
├── viewmodels/ # TrackerViewModel, SettingsViewModel (ChangeNotifier / Provider)
└── ui/
├── dashboard/
├── calendar/
├── achievements/
├── statistics/
├── recovery/
├── facts/
├── motivation/
├── settings/
├── more/
├── shell/ # HomeShell (NavigationBar)
└── widgets/ # AppCard, DayEntrySheet, AchievementUnlockDialog, ...

Pattern: MVVM. ViewModels extend ChangeNotifier and are provided via provider. Screens read from ViewModels and call ViewModel methods; they do not touch the database directly. All data is local (SQLite + SharedPreferences).

Building

Prerequisites

Tool	Version
Flutter (via fvm)	3.41.2 stable
Dart	3.11.0
Android SDK	at `~/Android/Sdk`
Android NDK	28.2 (installed in `~/Android/Sdk/ndk/`)
Java	17+

Flutter is managed by fvm. The project's .fvm/ config pins the version automatically.

Note — SDK path:android/local.properties points at ~/Android/Sdk. If Flutter rewrites it back to /opt/android-sdk during pub get, change sdk.dir back to /home/ben/Android/Sdk. The /opt SDK has no NDK and no accepted licenses.

Run the app

# With fvm on PATH (or use the full path):
flutter pub get
flutter run

Build a debug APK

flutter build apk --debug
# Output: build/app/outputs/flutter-apk/app-debug.apk

Build a release APK

flutter build apk --release

Run tests

flutter test

Covers streak calculation, longest-streak detection, monthly aggregation, and stats computation (7 unit tests in test/stats_service_test.dart).

Static analysis

flutter analyze
# Expected: No issues found

Android Manifest Notes

The app declares POST_NOTIFICATIONS and RECEIVE_BOOT_COMPLETED permissions for the optional daily reminder. No network permission is declared — the app is fully offline.

Dependencies

Package	Purpose
`provider`	MVVM state management
`sqflite`	Local SQLite database
`shared_preferences`	Theme + notification preferences
`fl_chart`	Statistics charts
`confetti`	Achievement milestone celebrations
`flutter_local_notifications`	Optional daily reminder
`timezone`	Reliable local-time scheduling
`intl`	Date formatting
`google_fonts`	Inter typeface
`path`	Database path construction

Don't Drink

Small daily choices. Big long-term changes.

A mobile app that helps you reduce or eliminate alcohol consumption through daily tracking, streaks, achievements, education, and motivation.

Features

Daily Tracker

Log exactly one status per day by tapping any date. Five levels:

Status	Color	Meaning
No Drinks	Green	0 alcoholic drinks
1–2 Drinks	Yellow	Light drinking
3–5 Drinks	Orange	Moderate drinking
6+ Drinks	Red	Heavy drinking
Blackout	Black	Extreme drinking / memory loss

You can edit any past day. Future days are disabled.

Streak Counter

The dashboard shows your current alcohol-free streak and your all-time longest streak. If today hasn't been logged yet, the streak is measured through yesterday so the counter doesn't reset just from not opening the app.

Color-Coded Calendar

Browse any month's color-coded grid. Navigate backward month by month. Tap any day to log or edit it.

Achievement System

Nine streak milestones unlock automatically — based on your longest ever streak, so a relapse doesn't erase a badge. Legendary milestones fire a confetti celebration.

Day	Achievement
1	Better Liver Begins
3	Better Hydration
7	Better Sleep
14	More Energy
30	One Month Strong ⭐
60	Mental Clarity
90	New Lifestyle ⭐
180	Half-Year Champion ⭐
365	One Year Alcohol-Free ⭐

Statistics

Bar chart of alcohol-free days over the last 6 months, a pie chart of drink-level distribution, and a headline overview (longest streak, free-day rate, best month).

Recovery Timeline

A milestone timeline showing what the body gains hour-by-hour and month-by-month when alcohol-free — with your current streak highlighted as "reached."

Facts & Education

A daily rotating fact card plus browsable lists of alcohol harms and benefits of not drinking.

Motivation

Swipeable full-bleed motivation cards. Tap Inspire me to jump to a random one.

Daily Reminder (optional)

An on-device scheduled notification at a time you choose (default 8:00 PM). Can be toggled off at any time. Requires notification permission.

Theme

Light, dark, or system-default — switchable in Settings.

Architecture

lib/
├── core/
│ ├── models/ # DrinkLevel, DayEntry, Achievement
│ ├── theme/ # AppTheme (Material 3), AppColors
│ └── utils/ # DateOnly helpers
├── data/
│ ├── database/ # AppDatabase (SQLite via sqflite)
│ ├── repositories/ # EntryRepository, SettingsRepository
│ └── static/ # Achievements, facts, recovery, motivation
├── services/ # StatsService, AchievementService, NotificationService
├── viewmodels/ # TrackerViewModel, SettingsViewModel (ChangeNotifier / Provider)
└── ui/
├── dashboard/
├── calendar/
├── achievements/
├── statistics/
├── recovery/
├── facts/
├── motivation/
├── settings/
├── more/
├── shell/ # HomeShell (NavigationBar)
└── widgets/ # AppCard, DayEntrySheet, AchievementUnlockDialog, ...

Pattern: MVVM. ViewModels extend ChangeNotifier and are provided via provider. Screens read from ViewModels and call ViewModel methods; they do not touch the database directly. All data is local (SQLite + SharedPreferences).

Building

Prerequisites

Tool	Version
Flutter (via fvm)	3.41.2 stable
Dart	3.11.0
Android SDK	at `~/Android/Sdk`
Android NDK	28.2 (installed in `~/Android/Sdk/ndk/`)
Java	17+

Flutter is managed by fvm. The project's .fvm/ config pins the version automatically.

Note — SDK path:android/local.properties points at ~/Android/Sdk. If Flutter rewrites it back to /opt/android-sdk during pub get, change sdk.dir back to /home/ben/Android/Sdk. The /opt SDK has no NDK and no accepted licenses.

Run the app

# With fvm on PATH (or use the full path):
flutter pub get
flutter run

Build a debug APK

flutter build apk --debug
# Output: build/app/outputs/flutter-apk/app-debug.apk

Build a release APK

flutter build apk --release

Run tests

flutter test

Covers streak calculation, longest-streak detection, monthly aggregation, and stats computation (7 unit tests in test/stats_service_test.dart).

Static analysis

flutter analyze
# Expected: No issues found

Android Manifest Notes

The app declares POST_NOTIFICATIONS and RECEIVE_BOOT_COMPLETED permissions for the optional daily reminder. No network permission is declared — the app is fully offline.

Dependencies

Package	Purpose
`provider`	MVVM state management
`sqflite`	Local SQLite database
`shared_preferences`	Theme + notification preferences
`fl_chart`	Statistics charts
`confetti`	Achievement milestone celebrations
`flutter_local_notifications`	Optional daily reminder
`timezone`	Reliable local-time scheduling
`intl`	Date formatting
`google_fonts`	Inter typeface
`path`	Database path construction

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
android		android
assets		assets
ios		ios
lib		lib
test		test
.fvmrc		.fvmrc
.gitignore		.gitignore
.metadata		.metadata
README.md		README.md
analysis_options.yaml		analysis_options.yaml
pubspec.lock		pubspec.lock
pubspec.yaml		pubspec.yaml

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
android		android
assets		assets
ios		ios
lib		lib
test		test
.fvmrc		.fvmrc
.gitignore		.gitignore
.metadata		.metadata
README.md		README.md
analysis_options.yaml		analysis_options.yaml
pubspec.lock		pubspec.lock
pubspec.yaml		pubspec.yaml

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
android		android
assets		assets
ios		ios
lib		lib
test		test
.fvmrc		.fvmrc
.gitignore		.gitignore
.metadata		.metadata
README.md		README.md
analysis_options.yaml		analysis_options.yaml
pubspec.lock		pubspec.lock
pubspec.yaml		pubspec.yaml

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
android		android
assets		assets
ios		ios
lib		lib
test		test
.fvmrc		.fvmrc
.gitignore		.gitignore
.metadata		.metadata
README.md		README.md
analysis_options.yaml		analysis_options.yaml
pubspec.lock		pubspec.lock
pubspec.yaml		pubspec.yaml

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
android		android
assets		assets
ios		ios
lib		lib
test		test
.fvmrc		.fvmrc
.gitignore		.gitignore
.metadata		.metadata
README.md		README.md
analysis_options.yaml		analysis_options.yaml
pubspec.lock		pubspec.lock
pubspec.yaml		pubspec.yaml

Latest commit

History

Folders and files

Repository files navigation

Don't Drink

Features

Daily Tracker

Streak Counter

Color-Coded Calendar

Achievement System

Statistics

Recovery Timeline

Facts & Education

Motivation

Daily Reminder (optional)

Theme

Architecture

Building

Prerequisites

Run the app

Build a debug APK

Build a release APK

Run tests

Static analysis

Android Manifest Notes

Dependencies

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Don't Drink

Features

Daily Tracker

Streak Counter

Color-Coded Calendar

Achievement System

Statistics

Recovery Timeline

Facts & Education

Motivation

Daily Reminder (optional)

Theme

Architecture

Building

Prerequisites

Run the app

Build a debug APK

Build a release APK

Run tests

Static analysis

Android Manifest Notes

Dependencies

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Don't Drink

Features

Daily Tracker

Streak Counter

Color-Coded Calendar

Achievement System