TrackerWebApp-Reactive 🍏

Welcome to the TrackerWebApp-Reactive repository! This project focuses on nutrient education and tracking, similar to the popular mobile app MyFitnessPal. Our aim is to provide a free, open-source solution that enhances user experience and accessibility.

Table of Contents

• Project Overview
• Features
• Technologies Used
• Installation
• Usage
• Contributing
• License
• Contact

Project Overview

The TrackerWebApp-Reactive project aims to empower users by providing tools for tracking their nutritional intake and educating them about healthy eating habits. With an intuitive interface and a range of features, this web application is designed to make nutrient tracking easy and effective.

Features

• User-Friendly Interface: Navigate easily through a clean and simple design.
• Nutrient Tracking: Log your meals and track your nutrient intake.
• Educational Resources: Access articles and tips on nutrition.
• Customizable Profiles: Set personal goals and track your progress.
• Community Support: Join discussions and share experiences with other users.

Technologies Used

This project leverages a variety of technologies to ensure a robust and scalable application. Here’s a list of the key technologies:

• Axios: For making HTTP requests.
• Docker: For containerization.
• Java: The primary programming language.
• JUnit: For testing.
• Liquibase: For database version control.
• Maven: For project management.
• PrimeVue: UI components for Vue.js.
• R2DBC: Reactive database connectivity.
• Reactive Programming: For responsive and efficient code.
• Sendinblue: For email services.
• Spring Boot: For building the application.
• Spring Security: For authentication and authorization.
• Tailwind CSS: For styling the application.
• Testcontainers: For integration testing.
• Vite: For fast frontend development.
• Vue.js: JavaScript framework for building user interfaces.
• Vuex: State management for Vue.js applications.
• WebFlux: For building reactive web applications.

Installation

To set up the TrackerWebApp-Reactive on your local machine, follow these steps:

1. Clone the repository:

   git clone https://github.com/iamkillwish/TrackerWebApp-Reactive.git
   cd TrackerWebApp-Reactive

2. Install dependencies:

   Make sure you have Java and Maven installed. Then run:

   mvn install

3. Set up Docker:

   Ensure Docker is running on your machine. You can build the Docker image using:

   docker-compose build

4. Run the application:

   Start the application with:

   docker-compose up

5. Access the application:

   Open your web browser and navigate to http://localhost:8080.

Usage

Once the application is running, you can start tracking your nutrients:

1. Create an Account: Sign up to access all features.
2. Log Meals: Use the meal logging feature to track what you eat.
3. View Nutrient Breakdown: Check your daily nutrient intake.
4. Read Articles: Explore educational resources on nutrition.
5. Join the Community: Participate in discussions with other users.

For more detailed instructions and updates, visit our Releases section.

Contributing

We welcome contributions to improve the TrackerWebApp-Reactive. To contribute:

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Make your changes and commit them.
4. Push your changes to your forked repository.
5. Submit a pull request.

Please ensure your code follows our coding standards and includes tests where applicable.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Contact

For questions or feedback, please reach out to the project maintainer:

• Name: [Your Name]
• Email: [Your Email]
• GitHub: iamkillwish

Thank you for checking out the TrackerWebApp-Reactive! We hope you find it useful in your journey towards better nutrition.