fit track Download - fit track Source code download

fit track

Other source code

1.0.0

Download

Fit-Track

Fit-Track is an exercise log-tracking application built using the MERN (MongoDB, Express, React+Vite, Node.js) stack. This documentation will guide you through the process of contributing to this project.

Installation

Frontend

Navigate to the frontend directory:
```
cd frontend
```
Install the dependencies:
```
npm install
```
Start the development server:
```
npm run dev
```

Backend

Navigate to the backend directory:
```
cd backend
```
Install the dependencies:
```
npm install
```
Setup MongoDB Atlas:
1. Go to MongoDB Atlas and create an account if you don't already have one.
2. Create a new cluster by following the prompts. Mongo Atlas Cluster Creation Tutorial
3. Once the cluster is created, go to the Database Access section and create a user with the necessary privileges.
4. Go to Network Access and allow your IP address (or allow access from anywhere if testing locally).
5. In the Clusters section, click Connect, then choose Connect your application. You'll see a connection string that looks like this:
```
mongodb+srv://<username>:<password>@cluster0.mongodb.net/?retryWrites=true&w=majority
```
6. Replace <username> and <password> with your actual MongoDB Atlas username and password. Copy the entire connection string.
Add MongoDB ATLAS_URI to .env file:
- Create a .env file in the backend directory.
- Add the following line to the .env file, replacing <your-mongodb-connection-string> with the connection string you copied from MongoDB Atlas:
```
ATLAS_URI=mongodb+srv://<username>:<password>@cluster0.mongodb.net/fit-track?retryWrites=true&w=majority
```
Start the server:
```
node server.js
```
or if nodemon is installed for live updates of backend:
```
nodemon server.js
```

Project Structure

Frontend

The frontend directory contains the React application.

public: Contains the public assets of the application.
src: Contains the source code of the application.
- components: Reusable UI components.
  - Home: HomePage Components
    - Exercise: Exercise row component to display Duration, Status, dayCheck
    - ExercisesList: To display the List of exercises done by user
    - HeatMap: Powered by ApexCharts.js to display the user exercise routine
    - Quotes: From API Ninjas and display the quotes randomly to motivate the user
    - TotalDays: To display number of days the user exercised
    - UserExperience: To display the User Experience with gamified experience
    - UserRoutine: To display the weekly routine of User like a streak
  - HomePage: Displaying and rendering Home Page
  - Login: Displaying a Login Page
  - SignUp: Displaying a SignUp and edit User Page
  - navbar: Navbar Component
App.jsx: The main component that sets up routes.
main.jsx: The entry point of the React application.

Backend

The backend directory contains the Node.js server and Express application.

models: Contains the Mongoose schemas.
- exercise.model: Exercise Schema
- user.model: User Schema
routes: Contains the API routes.
- exercises: Backend API Routes for exercises
- user: Backend API Routes for users
server.js: The entry point of the server application.

Contributing

We welcome contributions! To contribute to Fit-Track, follow these steps:

Forking the Repository

Fork the repository by clicking the "Fork" button at the top right of the repository page on GitHub.

Cloning the Repository

Clone your forked repository to your local machine:

git clone https://github.com/your-username/Fit-Track.git

Navigate to the project directory:
```
cd Fit-Track
```

Creating a Branch

Create a new branch for your feature or bug fix (create a branch according to the issue working on):
```
git switch -c your-branch-name
```

Making Changes

Make your changes to the codebase. You can edit the files using your preferred code editor.

Committing Changes

Add the changes to the staging area:
```
git add .
```
Commit the changes with a descriptive message:
```
git commit -m "Description of your changes"
```

Pushing Changes

Push the changes to your forked repository:
```
git push origin your-branch-name
```

Creating a Pull Request

Create a pull request from your forked repository to the main repository. Go to the "Pull Requests" tab on the main repository, and click "New Pull Request". Follow the instructions to create your pull request.

This is just the beginning! I look forward to making more meaningful contributions and collaborating with this amazing community. Let's build something great together and make Fit-Track the best it can be! ❤️?