A modern, fast, and interactive academic performance tracking web application built with Next.js (App Router), TypeScript, and Tailwind CSS.
MH GPA & CGPA Calculator v2 is designed to streamline academic grade tracking for university students. Whether you want to calculate your current semester GPA, track cumulative CGPA over several academic years, or project the exact grades required to achieve a target honors distinction, this tool provides real-time calculations and visual insights.
- 🎓 Multi-Semester Tracking: Organizes academic performance by semesters (Year 1 Sem 1, Year 1 Sem 2, etc.) to compute both Semester GPA (SGPA) and total Cumulative GPA (CGPA).
- ⚖️ Credit-Weighted Calculations: Accurately weights course grades by credit hours using standard university grading scales (
A+,A,A-,B+,B,B-,C+,C,C-,D,F). - 🎯 "What-If" Target GPA Predictor: Input your desired target graduation CGPA and remaining credit hours to get instant feedback on required average GPA and specific letter grade recommendations.
- 📊 Visual Analytics Dashboard: Interactive visual stats cards displaying overall CGPA, Total Credit Hours Completed, Total Courses Tracked, and Best Semester SGPA.
- 💾 Local Storage Persistence: Automatically saves all your courses, semesters, and preferences directly in your browser so you never lose data on page refresh.
- 📦 Export & Backup Data: Download a JSON backup of your academic plan or restore data across multiple devices.
- ⚙️ Customizable Grade Scales: Customize numerical point mappings (e.g.
A = 4.0,A- = 3.75) to match any university standard. - 🌙 Dark Mode Support: Seamless dark/light theme switching with smooth transitions and glassmorphic card designs.
| Semester Tracker & Course Manager | "What-If" Target GPA Predictor |
|---|---|
 |
 |
| Overview & Performance Stats | Guide & About Section |
|---|---|
 |
 |
Follow these steps to run the application locally on your machine.
Make sure you have Node.js installed:
- Node.js:
v18.0.0or higher - npm:
v9.0.0or higher
-
Clone the repository:
git clone https://github.com/mihretu-dev/GPA_Calculator.git cd GPA_Calculator -
Install dependencies:
npm install
-
Start the development server:
npm run dev
-
Open in Browser: Open http://localhost:3000 (or the port specified in terminal output) to view the app.
To create an optimized production build:
npm run build
npm run start| Technology | Purpose |
|---|---|
| Next.js | React framework with App Router architecture |
| TypeScript | Type-safe state management & calculation models |
| Tailwind CSS | Responsive styling, dark mode, and glassmorphic UI |
| Lucide React | Modern icon library |
| next-themes | Light/Dark theme switching |
Developed by Mihretu Hizkel (MH) — Hawassa University Alum & Full-Stack Developer.
- 🌐 Live Web App: gpa-calculator-nu-nine.vercel.app
- 🐙 GitHub: @mihretu-dev
✈️ Telegram: @Mihretu_H- 📸 Instagram: @mh_mire_
- 📧 Email: mihretuhizkel380@gmail.com
This project is licensed under the MIT License.