An open API service indexing awesome lists of open source software.

https://github.com/brandonp2412/quitter

Give up on addictions and become a Quitter 😎
https://github.com/brandonp2412/quitter

addiction addiction-recovery android dart flutter flutter-app habit-tracker linux mobile-app quit-smoking recovery sobriety sobriety-tracker windows

Last synced: 21 days ago
JSON representation

Give up on addictions and become a Quitter 😎

Awesome Lists containing this project

README

          

# Quitter

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


Current release number badge
Number of release downloads badge

## 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.

Get it on F-droid badgeGet it on Google Play badgeDownload from the Microsoft Store badgeGet it on web

# Screenshots


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
Alcohol quitting page on mobile at day 1 showing some infographics. A start button is on the bottom right
Smoking quitting page on mobile at day 7 of your quitting journey. A reset button is on the bottom right to trigger a relapse
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
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.
Marijuana quitting page on mobile at day 14. A reset button is on the bottom right.
The settings page showing several appearance options and some main screen toggles
The journal page showing how to log your thoughts & feelings for the day

# Translations

Quitter uses [Crowdin](https://crowdin.com/project/quitter) for it's translations. If you're interested in contributing, please click the badge below.

Crowdin | Agile localization for tech companies

# 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](https://flutter.dev/docs/get-started/install)

## Installation

1. **Clone the repository:**
```bash
git clone https://github.com/brandonp2412/Quitter.git quitter
cd quitter
```

2. **Get Flutter dependencies:**
```bash
flutter pub get
```

## Running the App

To run the app on a connected device or emulator:

```bash
flutter run
```