SmokingYou

Minimalist, data-oriented smoking tracker for Android based on Material 3 Expressive.

---

SmokingYou is designed to help you track and manage your smoking habits. By offering clear statistics, dynamic charts, home screen widgets, and motivational achievements, the app provides the insights needed to cut down or quit entirely.

Screenshots

Features

• Habit Tracking: Log entries with a single tap. A real-time timer displays the duration elapsed since your last cigarette.
• Home Screen Widgets:
  • Quick Add Widget (1x1): One-tap instant cigarette logging from your home screen.
  • Timer & Counter Widget (3x1): Displays live smoke-free timer, daily cigarette counter, and quick add action.
  • Includes widget placement setup with Android 12+ dynamic widget pinning support.
• Mindful Craving Pause: Take a mindful pause with breathing guidance to resist cravings and track successfully resisted attempts.
• Tapering Reduction Plan: Set gradual reduction goals, track daily limits, and complete check-ins to cut down smoking at your own pace.
• Historical Baseline Generator: Analyze past smoking habits, compute baseline statistics, and track projected money and health savings.
• Detailed Analytics & History: Interactive daily/weekly charts, craving trigger distributions (including alcohol, stress, coffee, etc.), and editable logs.
• WHO Health & Financial Stats: Track total count, averages, daily extremes, longest smoke-free streak, financial savings, and WHO health recovery milestones.
• Achievements System: Unlock milestone badges and secret achievements for consistency and smoke-free intervals with local notifications.
• Data Portability: Local backup and restore (JSON export/import) to secure your logs.
• Highly Customizable Themes:
  • Standard Light, Dark, and System themes.
  • AMOLED Dark Mode for extra power saving.
  • Dynamic Colors (Material You) matching system wallpaper on Android 12+.
  • Curated color presets (Classic, Sage, Rose, Ocean, Lavender, Purple, Amber, Crimson, Slate).
  • Custom font presets.
  • Dynamic App Icons (change the app icon directly from settings).

Tech Stack

• Language: Kotlin (Coroutines, Flow)
• UI Framework: Jetpack Compose with Material 3 Expressive
• Widgets: Jetpack Glance — modern declarative home screen widgets.
• Data Persistence:
  • Room Database — local storage with automated schema migrations.
  • Jetpack DataStore — settings, tapering preferences, and baseline stats.
  • GSON — data backup serialization.
• Dependency Injection: Koin — lightweight dependency injection framework.

Localization

Currently supported languages:

• English
• Russian
• German
• Spanish
• French
• Italian
• Portuguese
• Turkish
• Ukrainian

Installation

1. Download the latest APK from the Releases page.
2. Ensure installation from unknown sources is allowed in your Android settings.
3. Install the APK on your device.

Special Thanks

Special thanks to the following projects for design ideas and inspiration:

• Tomato and Zenith - For beautiful interface concepts and inspiration, Material 3 Expressive guidelines implementation ideas and design inspiration.

Contributing

Contributions are welcome. If you find a bug or have a feature suggestion, please open an issue or submit a pull request.