Skip to content

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

2 stars

Watchers

1 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages