GPAHub Architecture & Engineering
System ArchitectureA decoupled, configuration-driven platform for Indian university grading systems.
About GPAHub
GPAHub is an academic calculation tool designed to simplify university-specific GPA/CGPA calculations. It provides a standardized credit and grading interface for Indian technical and general university students, supporting both official university schemes and custom user institutions without requiring account setup or cloud data storage.
Rule #1: Strict Separation of Data vs Logic vs UI
University rules are NEVER hardcoded inside React components.
Declarative JSON/JS objects for grade scale, percentage formula, courses, semesters & subjects.
Pure, un-coupled JavaScript functions evaluating SGPA, CGPA & formula conversions.
Reusable React views rendering inputs and dynamic scorecards based on active configurations.
How to Add a New University (7 Steps)
When adding a new university to GPAHub, a developer only needs to define configuration files. No calculator UI code is modified.
University Configuration
Define university metadata, short code, state, city and category in src/data/universities/
Grade Rules
Specify grade letters, grade points, passing status, and marks ranges in src/data/gradeRules/
Conversion Formula
Choose rule type (multiply, subtractThenMultiply, piecewise, directMarks) in src/data/conversionRules/
Courses & Semesters
Add degree programs (B.Tech, BCA, etc.) with semester counts in src/data/courses/
Subjects & Credits
List theory, lab, project, and elective courses with credit weights
Logo Configuration
Assign university logo path or fallback to GPAHub default logo
Register in Index
Export from src/data/universities/index.js — engine instantly activates!
GPAHub is an independent academic calculation tool. Results are based on the configured academic rules and should be verified with your university's official regulations where required.