Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yettabaa/bac-note-calculator
Bac Note Calculator is a React-based web application designed to help students calculate their current grades for the Baccalaureate exam. This app is ideal for students preparing for the Baccalaureate, offering a clear understanding of their current academic standing and the goals they need to achieve success.
https://github.com/yettabaa/bac-note-calculator
bac calculator calculator-bac react webapp
Last synced: 11 days ago
JSON representation
Bac Note Calculator is a React-based web application designed to help students calculate their current grades for the Baccalaureate exam. This app is ideal for students preparing for the Baccalaureate, offering a clear understanding of their current academic standing and the goals they need to achieve success.
- Host: GitHub
- URL: https://github.com/yettabaa/bac-note-calculator
- Owner: yettabaa
- License: mit
- Created: 2024-04-10T20:11:12.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-11-19T21:40:48.000Z (3 months ago)
- Last Synced: 2024-12-07T01:29:54.771Z (2 months ago)
- Topics: bac, calculator, calculator-bac, react, webapp
- Language: JavaScript
- Homepage: https://yettabaa.github.io/Bac-Note-Calculator/
- Size: 1.45 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# **Bac Note Calculator**
👉
[](https://yettabaa.github.io/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](#live-demo)
2. [Features](#features)
3. [Technologies Used](#technologies-used)
4. [Installation & Usage](#installation--usage)
5. [Preview](#preview)
6. [Contributing](#contributing)
7. [Future Enhancements](#future-enhancements)
8. [License](#license)
---
## **1. Live Demo**
👉 [Check out the Bac Note Calculator here](https://yettabaa.github.io/Bac-Note-Calculator)
---
## **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:
```bash
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:
```bash
docker-compose up --build
````
Access the app at: [http://localhost:3000/Bac-Note-Calculator](http://localhost:3000/Bac-Note-Calculator).
### **Without Docker**
Install dependencies:
```bash
npm install
````
Start the development server:
```bash
npm start
````
Access the app at: [http://localhost:3000](http://localhost:3000/Bac-Note-Calculator).
## **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.
```bash
git checkout -b feature-branch-name
````
3. Commit changes.
```bash
git commit -m "Description of changes"
````
4. Push to your branch.
```bash
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](LICENSE).
---