Supplements Tracker
A Flutter application designed to help you track your daily supplement intake, manage dosages, and set reminders. This app aims to provide a simple and intuitive way to stay on top of your supplement regimen.
Features
- Supplement Management: Easily add, edit, and delete supplements, including details like name, dosage, and frequency.
- Intake Tracking: Log your daily supplement intake, marking when you've taken your doses.
- Reminders: Set up local notifications to remind you when it's time to take your supplements.
- Customizable Theme: Switch between light and dark themes to suit your preference.
- Local Data Storage: All your supplement data is stored locally on your device.
Technologies Used
- Flutter: The UI toolkit used for building natively compiled applications for mobile, web, and desktop from a single codebase.
- Provider: A robust state management solution for Flutter applications.
- sqflite: For efficient local database persistence using SQLite.
- shared_preferences: To persist user settings and preferences locally.
- flutter_local_notifications: For scheduling and displaying local notifications to remind you about dosages.
- timezone: Ensures accurate time zone handling for notification scheduling.
- intl: For internationalization and flexible date/time formatting.
Getting Started
Follow these instructions to get a copy of the project up and running on your local machine for development and testing purposes.
Prerequisites
Before you begin, ensure you have the following installed:
- Flutter SDK: Refer to the official Flutter installation guide for detailed instructions.
- An Integrated Development Environment (IDE) such as VS Code with the Flutter extension, or Android Studio.
Installation
-
Clone the repository:
git clone https://github.com/vleeuwenmenno/supplements.git cd supplements
-
Get dependencies: Navigate to the project directory and run:
flutter pub get
Running the Application
To run the application on a connected device or emulator:
flutter run
To build a release version for a specific platform:
- Android APK:
flutter build apk --release
- iOS (requires macOS and Xcode):
flutter build ios --release
Contributing
Contributions are welcome! If you have suggestions for improvements or new features, please feel free to open an issue or submit a pull request.
License
This project is licensed under the MIT License - see the LICENSE file for details.