Skip to content

Repository files navigation

Pokhara University SGPA, CGPA, Grade & Percentage Calculator

A free, open-source academic calculator for Pokhara University Bachelor of Engineering (BE) students. Enter your semester grades to get SGPA, CGPA, equivalent letter grade, and percentage — with support for retakes, backlogs, electives, and printable reports. Runs entirely in the browser with no sign-up required.

Live · GitHub


Features

  • Program-specific course maps — Pre-loaded semester structures for Software, Computer, Civil, and Electrical Engineering
  • Old & new syllabus support — Switch between syllabus modes; course lists update automatically
  • Elective selection — Pick specific elective courses (Elective I, II, III) in upper semesters
  • Retake & backlog tracking — Mark retaken courses and optionally exclude F grades from GPA
  • Instant calculations — SGPA, CGPA, letter grade, and percentage update as you enter grades
  • Target CGPA planner — See the SGPA you need in remaining semesters to hit a goal
  • CSV export & import — Back up grades, download a blank template, or restore from a spreadsheet
  • Printable report — Generate a clean grade sheet with student details for printing or sharing
  • Fully client-side — All data stays in your browser via localStorage; nothing is sent to a server
  • Mobile-friendly — Responsive layout that works on phones, tablets, and desktops

Supported Programs

Program Old Syllabus New Syllabus
Software Engineering
Computer Engineering
Civil Engineering
Electrical Engineering

How GPA Is Calculated

Pokhara University uses a 4.0 honor-point scale:

Grade Honor Point
A 4.0
A- 3.7
B+ 3.3
B 3.0
B- 2.7
C+ 2.3
C 2.0
C- 1.7
D+ 1.3
D 1.0
F 0.0
  • SGPA = Total Quality Points ÷ Total Credit Hours (for the semester)
  • CGPA = Cumulative Quality Points ÷ Cumulative Credit Hours (across all graded semesters)
  • Quality Points = Credit Hours × Honor Point for each course

Grade & Percentage

Alongside SGPA and CGPA, the calculator shows your cumulative letter grade and percentage based on Pokhara University's official conversion rules.

Letter grade from CGPA

CGPA Range Letter Grade
4.00 A
3.70 – 3.99 A-
3.30 – 3.69 B+
3.00 – 3.29 B
2.70 – 2.99 B-
2.30 – 2.69 C+
2.00 – 2.29 C
1.70 – 1.99 C-
1.30 – 1.69 D+
1.00 – 1.29 D
Below 1.00 F

Percentage from CGPA

Percentage is looked up from CGPA using PU's official conversion table (every 0.01 step from 2.00 to 4.00). A CGPA below 2.00 does not map to a percentage.

CGPA Percentage CGPA Percentage
2.00 60.0% 3.00 75.0%
2.50 67.5% 3.50 82.5%
2.75 70.9% 3.75 85.9%
4.00 90.0%

These values appear in the Grand CGPA panel and on the printable report sheet.

Getting Started

Prerequisites

  • Node.js 18 or later
  • npm (comes with Node.js)

Installation

git clone https://github.com/nabinkdl/PU-GPA-Tracker.git
cd PU-GPA-Tracker
npm install

Development

npm run dev

Open http://localhost:3000 in your browser.

Production Build

npm run build
npm run preview

The static site is output to the dist/ folder and can be deployed to any static host (Vercel, Netlify, GitHub Pages, etc.).

Available Scripts

Command Description
npm run dev Start the Vite dev server on port 3000
npm run build Type-check and build for production
npm run preview Serve the production build locally
npm run lint Run TypeScript type checking
npm run clean Remove the dist/ build folder

Project Structure

├── src/
│   ├── App.tsx                  # Main app shell and state management
│   ├── components/
│   │   ├── GPAResults.tsx       # CGPA panel, CSV tools, target planner
│   │   ├── SemesterView.tsx     # Per-semester grade entry
│   │   └── PrintReportSheet.tsx # Printable grade report
│   ├── courseData*.ts           # Course catalogs per program & syllabus
│   ├── registry.ts              # Program → course data mapping
│   ├── mapping.ts               # Grade points & CGPA → percentage table
│   ├── utils.ts                 # SGPA / CGPA calculation logic
│   ├── exportImport.ts          # CSV export and import
│   └── types.ts                 # Shared TypeScript types
├── index.html
├── vite.config.ts
└── package.json

Tech Stack

Contributing

Contributions are welcome — whether that's fixing course data, adding a new program, improving calculations, or polishing the UI.

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/your-feature
  3. Make your changes and verify with npm run lint && npm run build
  4. Commit with a clear message
  5. Open a pull request describing what you changed and why

Found a bug or have a feature idea? Open an issue.

If you're updating course catalogs, edit the relevant courseData*.ts file for the program and syllabus you are targeting. Do not change calculation logic unless you can reference the official PU grading policy.

Privacy Policy

The full privacy policy is available in the app at /privacy and in this repository below.

Your privacy is important.

This GPA Calculator stores all academic data locally on your device using your browser's storage. No grades, personal information, or academic records are transmitted to, collected by, or stored on any external server.

What Data Is Stored?

  • Subjects and grades entered by you
  • SGPA and CGPA calculation records
  • Application preferences and settings

What Data Is Collected?

None. This application does not collect, track, sell, or share any personal information.

Data Security

Since all data remains on your device, you have full control over it. Clearing your browser data or uninstalling the application may permanently remove stored information.

Third-Party Services

This application uses Vercel Web Analytics for anonymous page-view metrics only. It does not receive grades or other calculator data. We do not use advertising or other third-party tracking services.

Disclaimer

This application is an independent project created for Pokhara University Bachelor of Engineering students. It is not affiliated with, endorsed by, or officially associated with Pokhara University.

By using this application, you acknowledge that GPA calculations are provided for informational purposes only and should be verified against official university records when necessary.

License

This project is licensed under the MIT License.


Made with ♥️ for Pokhara University BE students by Nabin Kandel (@nabinkdl).

If this tool helped you, consider buying me a momo

About

Enter your semester grades to get SGPA, CGPA, equivalent letter grade, and percentage

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages