Skip to content

A web app for students to input, track, and calculate semester GPAs and cumulative CGPA with automatic grade conversion and visual progress.

Notifications You must be signed in to change notification settings

CodewithShahriar/CGPATrack

Repository files navigation

🎓 CGPATrack

CGPATrack is a modern web application built to help students easily input, track, and calculate their semester GPA and cumulative CGPA, with automatic grade conversion, credit tracking, and performance summaries.

📊 Designed to simplify academic record-keeping for students and offer clear insights into their academic progress.


🧩 Features

  • 📥 Add unlimited semesters and courses
  • 🧮 Auto-calculate Semester GPA & CGPA
  • 🔁 Grade-to-GPA conversion (customizable scale)
  • 📈 CGPA tracking across semesters
  • 🏁 Total credits completed
  • 🗂 Downloadable CGPA report (planned)
  • 🌗 Dark/Light mode toggle (planned)
  • 📊 GPA trend chart using Chart.js
  • 🧠 Clean, user-friendly UI with responsive design

🔧 Technologies Used

  • Frontend Framework: React with TypeScript
  • UI Components: shadcn/ui (built on Radix UI)
  • Styling: Tailwind CSS
  • Routing: React Router
  • State Management: React Context API
  • Data Storage: Local Storage (browser)
  • Build Tool: Vite
  • Package Manager: npm/bun
  • Notifications: Sonner toast library
  • Data Fetching: TanStack React Query
  • Utilities: UUID for generating unique ID

📁 Component / Page Structure


🧠 How It Works

  1. Input semester → Add courses with credit hours and grades
  2. Auto-calculation → App converts grades to GPA and computes semester average
  3. CGPA tracking → CGPATrack keeps a running CGPA and total credits
  4. Visualization → Optional chart view shows GPA trends semester by semester

🔜 Upcoming Features

  • 📤 Export CGPA & attendance summary as PDF
  • ☁️ Firebase login system to save data across devices
  • 📊 GPA prediction calculator: “What do I need next semester to reach X CGPA?”
  • 📱 Mobile-first UI improvements
  • 📁 Export semester data to Excel/CSV

📸 Screenshots (Coming Soon)

Will include dashboard preview, GPA chart, and CGPA summary panel.


📄 License

This project is open-source and free to use for educational purposes.
Feel free to fork, contribute, or customize for your institution!


🚀 Author

Abid Shahriar
📫 abidshahriarofficial@gmail.com
🌐 shahriardev.netlify.app


“Build tools that make students’ lives easier — not harder.”

About

A web app for students to input, track, and calculate semester GPAs and cumulative CGPA with automatic grade conversion and visual progress.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages