Skip to content

Repository files navigation

ViceFree

ViceFree is a mobile app for quitting bad habits — smoking, drinking, or any other vice. Add the vices you want to quit, and ViceFree tracks how long you've stayed clean, helping you stay motivated with a clear view of your progress.

Features

  • Track multiple vices — add any vice you're quitting (e.g. smoking, drinking) with a custom name and color
  • Streak tracking — see how much time has passed since you started quitting each vice
  • Edit & delete — update or remove a vice as your journey progresses
  • Onboarding walkthrough — a short introduction screen for first-time users
  • Customizable theme — personalize the app's look via Settings
  • Privacy Policy & Terms pages — built-in legal documents
  • Local storage — all data is stored on-device, no account required

Tech Stack

Project Structure

The codebase follows a clean-architecture-style layout:

lib/
├── 0_data/         # Models, exceptions, and data sources
├── 1_domain/       # Entities, failures, and use cases
├── 2_application/  # Pages, cubits, services, and shared widgets
└── main.dart       # App entry point

Getting Started

  1. Install Flutter (SDK ^3.6.0).
  2. Install dependencies:
    flutter pub get
  3. Run the app:
    flutter run

License

This project is currently unpublished (publish_to: 'none') and intended for private/personal use.

About

ViceFree — A Flutter app to help you quit bad habits like smoking and drinking. Track your streaks, stay motivated, and monitor your progress toward a healthier life.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages