焕新之旅 (Quitting Smoking Journey)

A comprehensive Flutter application designed to help users quit smoking by tracking progress, providing health insights, and offering coping strategies.

Features

Core Features

• User Authentication: Complete registration and login system
• Progress Tracking: Calculate and display days without smoking
• Daily Check-in: Mark each smoke-free day
• Health Benefits Tracking: Visualization of improving health metrics over time
• Achievement System: Unlock achievements as you progress
• Craving Management: Access to coping strategies when cravings strike
• Breathing Exercises: Guided breathing exercises to reduce stress

Additional Features

• Multi-language Support: Available in English and Chinese
• Dark Mode: Customizable UI theme
• Notifications: Reminders and encouragement notifications
• Personalization: Set your smoking history and quit date
• Privacy-focused: All data stored locally by default

Screenshots

(Screenshots will be added soon)

Getting Started

Prerequisites

• Flutter SDK (version 3.0.0 or higher)
• Dart SDK (version 2.17.0 or higher)
• Android Studio / VS Code with Flutter extensions

Installation

1. Clone the repository

   git clone https://github.com/himym1/quitting_smoking.git
   

2. Navigate to project folder

   cd quitting_smoking
   

3. Install dependencies

   flutter pub get
   

4. Run the app

   flutter run
   

Project Structure

• lib/core/: Core functionality and app-wide utilities
• lib/data/: Data layer including repositories and data sources
• lib/domain/: Business logic and domain models
• lib/presentation/: UI components and screens
• lib/l10n/: Localization resources

Technologies Used

• Flutter: UI framework
• Riverpod: State management
• GoRouter: Navigation
• Hive: Local data storage
• Flutter Local Notifications: Notification system

Roadmap

• Enhanced progress statistics and visualizations
• Community features for shared experiences
• Customizable coping strategy recommendations
• Advanced notification system with deep linking
• Cloud sync for multi-device support

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgements

• All the contributors who have invested their time in improving this app
• The Flutter community for their invaluable resources