Quitter

Record your quitting journey with a Free and Open Source app.

<p float="left"> <a href="https://github.com/brandonp2412/Quitter/releases/latest"><img alt="Current release number badge" src="https://img.shields.io/github/v/release/brandonp2412/quitter?style=for-the-badge&logoColor=d3bcfd&labelColor=2e4057&color=151218"></a> <a href="https://shields.io/badges/git-hub-downloads-all-assets-all-releases"><img alt="Number of release downloads badge" src="https://img.shields.io/github/downloads/brandonp2412/Quitter/total.svg?style=for-the-badge&logoColor=d3bcfd&labelColor=2e4057&color=151218"></a> </p>

Features

• 🕵️ No tracking We don't save any of your user data. Everything is stored locally.
• 🌍 No internet Our app doesn't request internet access, at all.
• 🚀 Multiple journeys Monitor progress for different habits simultaneously.
• 🎯 Milestone tracking Record and celebrate key achievements in your quitting journey.
• 📔 Journaling Write your thoughts and feelings as you progress.
• 🔔 Notifications Be encouraged with progress notifications.
• ⚙️ Completely custom Toggle features on/off, change colors & themes with settings.

<a href='https://f-droid.org/en/packages/com.quitter.app/'><img alt='Get it on F-droid badge' height="80" src='./docs/get-it-on-fdroid.png'/></a><a href='https://play.google.com/store/apps/details?id=com.quitter.app'><img alt='Get it on Google Play badge' height="80" src='./docs/get-it-on-google-play.png'/></a><a href="https://apps.microsoft.com/detail/9PKVZWDG3FGC?referrer=appbadge&mode=direct"><img src="./docs/download-msstore.svg" style="height: 80px !important" alt="Download from the Microsoft Store badge"/></a><a href='https://brandonp2412.github.io/Quitter/'><img alt='Get it on web' height="80" src='./docs/get-it-on-web.png'/></a>

Screenshots

<p class="float-left"> <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/1_en-US.png" height="600" alt="Home page for the mobile app showing tiles for Alcohol, Vaping, Smoking, Marijuana, Nicotine pouches, Opioids and Social Media. Bottom right button for adding custom entries"> <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/2_en-US.png" height="600" alt="Alcohol quitting page on mobile at day 1 showing some infographics. A start button is on the bottom right"> <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/3_en-US.png" height="600" alt="Smoking quitting page on mobile at day 7 of your quitting journey. A reset button is on the bottom right to trigger a relapse"> <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/4_en-US.png" height="600" alt="Custom entry page editing on mobile. A title field, quit date field, color picker and icon pickers are visible. A save button is on the bottom right"> <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/5_en-US.png" height="600" alt="The home page indicating what happens when you long press the Smoking tile. It shows a bottom sheet asking whether you want to hide Smoking or not."> <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/6_en-US.png" height="600" alt="Marijuana quitting page on mobile at day 14. A reset button is on the bottom right."> <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/7_en-US.png" height="600" alt="The settings page showing several appearance options and some main screen toggles"> <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/8_en-US.png" height="600" alt="The journal page showing how to log your thoughts & feelings for the day"> </p>

Translations

Quitter uses Crowdin for it's translations. If you're interested in contributing, please click the badge below.

<a href="https://crowdin.com/project/quitter" rel="nofollow"><img style="width:140;height:40px" src="https://badges.crowdin.net/badge/dark/crowdin-on-light.png" srcset="https://badges.crowdin.net/badge/dark/crowdin-on-light.png 1x,https://badges.crowdin.net/badge/dark/crowdin-on-light@2x.png 2x" alt="Crowdin | Agile localization for tech companies" /></a>

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

This project is built with Flutter. Ensure you have Flutter installed on your system. If not, follow the official Flutter installation guide: https://flutter.dev/docs/get-started/install

Installation

1. Clone the repository:

   git clone https://github.com/brandonp2412/Quitter.git quitter
   cd quitter
   

2. Get Flutter dependencies:

   flutter pub get
   

Running the App

To run the app on a connected device or emulator:

flutter run