Skip to content

Targeted at fitness enthusiasts, beginners looking for guidance, and individuals aiming to improve their overall well-being, "FitTrack" addresses the common struggles of staying committed to a fitness routine.

License

Notifications You must be signed in to change notification settings

CCRami/FitTrack-PI-ARCTIC

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿš€ FiTrack-PI-ARCTIC ๐Ÿ‹๏ธโ€โ™‚๏ธ

Maintaining an active and healthy lifestyle can be challenging, especially when motivation, structured guidance, and social support are lacking. FiTrack is an all-in-one fitness web application designed to empower users in achieving their health and wellness goals. It offers a comprehensive set of tools for:

  • ๐Ÿƒ Workout tracking
  • ๐Ÿฅ— Personalized diet planning
  • ๐Ÿข Sports facility promotions
  • ๐Ÿค Fitness community engagement

๐ŸŽฏ Why FiTrack?

Targeted at fitness enthusiasts, beginners seeking guidance, and individuals aiming to improve their overall well-being, FiTrack addresses the common struggles of staying committed to a fitness routine. The platform integrates social features, such as finding a sports buddy or a personal trainer nearby, fostering a community-driven environment that enhances accountability and motivation.

Beyond fitness, FiTrack aligns with key Sustainable Development Goals (SDGs):

  • ๐ŸŒ SDG 3 (Good Health and Well-being): Promoting an active lifestyle and preventive healthcare.
  • ๐Ÿค SDG 17 (Partnerships for the Goals): Encouraging collaboration between sports facilities, trainers, and users to create a more connected and health-conscious society.

Users can enjoy gamified features ๐ŸŽฎ such as XP points, leaderboards, and rewards ๐Ÿ†, ensuring a fun and engaging fitness journey while making meaningful progress toward their health goals.


๐Ÿ› ๏ธ Technologies Used

  • ๐ŸŽจ Frontend: Angular 15, TypeScript, Bootstrap
  • ๐Ÿ—๏ธ Backend: Spring Boot, Java, MySQL
  • ๐Ÿšข Tools & Deployment: Docker, REST API, JWT Authentication

๐ŸŽจ Frontend - Angular

This project was generated with Angular CLI version 15.1.3.

โ–ถ๏ธ Development Server

Run the following command to start the development server:

cd frontend
npm install
ng serve

Navigate to http://localhost:4200/. The application will automatically reload if you modify any source files.

๐Ÿ—๏ธ Code Scaffolding

Generate a new component using:

ng generate component component-name

You can also generate other elements like directives, pipes, services, classes, guards, interfaces, enums, or modules:

ng generate directive|pipe|service|class|guard|interface|enum|module

๐Ÿ—๏ธ Building the Project

Run:

ng build

The build artifacts will be stored in the dist/ directory.

๐Ÿงช Running Unit Tests

ng test

Executes unit tests via Karma.

๐Ÿ” Running End-to-End Tests

ng e2e

Executes end-to-end tests via a platform of your choice. Install a package that implements end-to-end testing capabilities before using this command.

โ“ Further Help

For more Angular CLI commands, run:

ng help

Or check out the Angular CLI Documentation.


๐Ÿ—๏ธ Backend - Spring Boot

The backend is built with Spring Boot, providing RESTful APIs for user authentication, workout tracking, and fitness data management.

๐Ÿ› ๏ธ Setup & Running the Backend

๐Ÿ”— Clone the repository

git clone https://github.com/your-repo/FiTrack-PI-ARCTIC.git
cd backend

๐Ÿ›ข๏ธ Configure the database

Update application.properties or application.yml with your MySQL credentials:

server.port = 8095

### DATABASE ###
spring.datasource.url=jdbc:mysql://localhost:3306/fitrack?createDatabaseIfNotExist=true&useUnicode=true&useJDBCCompliantTimezoneShift=true&useLegacyDatetimeCode=false&serverTimezone=UTC
spring.datasource.username=root
spring.datasource.password=

โ–ถ๏ธ Run the application

Using Maven:

mvn spring-boot:run

Or using Java directly:

java -jar target/fitrack-1.0.0.jar

๐Ÿ”— API Endpoints

Under Construction ๐Ÿšง

๐Ÿงช Running Tests

Run unit and integration tests with:

mvn test

๐Ÿ“ฆ Building the Project

Package the application as a JAR file:

mvn clean package

This will generate target/fitrack-1.0.0.jar, which you can run with:

java -jar target/fitrack-1.0.0.jar

โ“ Further Help

For more Java CLI commands, run:

java --help

Or check out the Java CLI Documentation.


๐Ÿณ Docker Support

If using Docker, you can build and run the application using:

docker-compose up --build

๐Ÿค Contributing

Contributions are welcome! Feel free to submit a pull request or open an issue if you encounter any problems.


๐Ÿ“œ License

This project is licensed under the GPL-3.0 license.

About

Targeted at fitness enthusiasts, beginners looking for guidance, and individuals aiming to improve their overall well-being, "FitTrack" addresses the common struggles of staying committed to a fitness routine.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 6