Bac Note Calculator

👉
A React-based web application designed to help students calculate their current grades for the Baccalaureate exam. The app provides a clear understanding of their academic standing and helps them set realistic goals for success.

---

Table of Contents

1. Live Demo
2. Features
3. Technologies Used
4. Installation & Usage
5. Preview
6. Contributing
7. Future Enhancements
8. License

---

1. Live Demo

👉 Check out the Bac Note Calculator here

---

2. Features

• Calculate the required points in the final baccalaureate exam to obtain the baccalaureate.
• Calculate real-time grades for Baccalaureate students.
• User-friendly interface for inputting grades and weights.
• Provides insights into current academic performance.
• Helps students identify goals for success.
• Fully responsive design for desktop and mobile users.

---

3. Technologies Used

• Frontend: React, CSS
• Deployment: GitHub Pages
• Containerization: Docker, Docker Compose

---

4. Installation & Usage

Run Locally

Clone the repository:

git clone https://github.com/yettabaa/Bac-Note-Calculator.git
cd Bac-Note-Calculator

Using Docker Compose

Run the following command to build and start the application:

docker-compose up --build

Access the app at: http://localhost:3000/Bac-Note-Calculator.

Without Docker

Install dependencies:

npm install

Start the development server:

npm start

Access the app at: http://localhost:3000.

5. Preview

---

6. Contributing

Contributions are welcome! If you have suggestions for improving this project, feel free to fork the repository and submit a pull request.

1. Fork the repo.
2. Create a new branch.

git checkout -b feature-branch-name

3. Commit changes.

git commit -m "Description of changes"

4. Push to your branch.

git push origin feature-branch-name

5. Open a pull request.

---

7. Future Enhancements

• Add grade prediction based on past performance.
• Support multiple grading systems.
• Provide statistical insights and personalized recommendations.

---

8. License

This project is licensed under the MIT License.

---