DEV Community

Abid niazi
Abid niazi

Posted on

How I Built a Free CGPA, MDCAT & Merit Calculator for Pakistani Students

#ai #webdev #programming #productivity

Pakistani students get ignored by most tools on the internet.

Every CGPA calculator uses the US 4.0 grading scale. Every merit calculator
doesn't know what NUST or FAST or MDCAT is. Every EMI calculator shows
interest rates in USD.

So I built ToolForge — a free toolkit specifically for Pakistan. Here's what
I learned building three of its most-used calculators.

The CGPA Calculator Problem

Pakistan's Higher Education Commission (HEC) uses a grading scale that's
subtly different from the US system most calculators are built on.

The key difference: in Pakistan, both A and A+ map to 4.0 grade points.
In the US, A+ is sometimes 4.3. This sounds minor but it causes significant
errors when students use US-based calculators for Pakistani universities.

Here's the HEC scale:

A+ = 4.0  (90–100%)
A  = 4.0  (85–89%)
A- = 3.7  (80–84%)
B+ = 3.3  (75–79%)
B  = 3.0  (70–74%)
B- = 2.7  (65–69%)
C+ = 2.3  (60–64%)
C  = 2.0  (55–59%)
F  = 0.0  (below 50%)
Enter fullscreen mode Exit fullscreen mode

The CGPA formula itself is straightforward:

function calculateCGPA(subjects) {
  const totalWeightedPoints = subjects.reduce((sum, subject) => {
    return sum + (subject.gradePoints * subject.creditHours);
  }, 0);

  const totalCreditHours = subjects.reduce((sum, subject) => {
    return sum + subject.creditHours;
  }, 0);

  return (totalWeightedPoints / totalCreditHours).toFixed(2);
}
Enter fullscreen mode Exit fullscreen mode

The tricky part was building the UI to dynamically add/remove subjects
while keeping the calculation reactive. I used React state with an array
of subject objects:

const [subjects, setSubjects] = useState([
  { id: 1, name: '', grade: 'A', creditHours: 3 }
]);
Enter fullscreen mode Exit fullscreen mode

Try the live calculator: freetoolforge.org/tools/calculators/gpa-calculator

The MDCAT Aggregate Calculator

MDCAT (Medical and Dental College Admission Test) uses a specific formula
that most calculators get wrong:

MDCAT Merit = (Matric % × 10%) + (FSc % × 40%) + (MDCAT Score × 50%)
Enter fullscreen mode Exit fullscreen mode

Different universities then apply their own cutoffs on top of this aggregate.
I built a version that calculates the standard PMC formula and shows you
which universities you're likely eligible for based on last year's cutoffs.

function calculateMDCATAggregate(matric, fsc, mdcatScore) {
  const matricWeight = (matric / 100) * 10;
  const fscWeight = (fsc / 100) * 40;
  const mdcatWeight = (mdcatScore / 200) * 50;

  return (matricWeight + fscWeight + mdcatWeight).toFixed(2);
}
Enter fullscreen mode Exit fullscreen mode

Live tool: freetoolforge.org/tools/calculators/mdcat-aggregate-calculator

The Merit Calculator Challenge

The Merit Calculator was the hardest to build — not because of the math,
but because every Pakistani university has a different formula:

  • NUST: Entry test 75% + FSc 15% + Matric 10%
  • FAST: Their own aptitude test with its own weighting
  • UET Lahore: Matric + FSc + UET entry test
  • LUMS: SAT-based, entirely different system I ended up building it with a dropdown to select the university, then dynamically rendering the correct formula and input fields.

The key technical decision: I stored all university formulas in a config
object rather than hardcoding them, so adding a new university is just
adding an object entry:

const UNIVERSITY_FORMULAS = {
  NUST: {
    label: 'NUST',
    formula: (matric, fsc, entryTest) =>
      (matric * 0.10) + (fsc * 0.15) + (entryTest * 0.75),
    fields: ['Matric %', 'FSc %', 'NET Score (out of 200)']
  },
  UET: {
    label: 'UET Lahore',
    formula: (matric, fsc, entryTest) =>
      (matric * 0.10) + (fsc * 0.40) + (entryTest * 0.50),
    fields: ['Matric %', 'FSc %', 'UET Entry Test %']
  }
  // ... more universities
};
Enter fullscreen mode Exit fullscreen mode

Live tool: freetoolforge.org/tools/calculators/merit-calculator

What I Learned Building Pakistan-Specific Tools

1. Context is everything.
A generic calculator is useless to a Pakistani student. Pakistan has its own
grading scales, tax slabs, bank rates, and admission formulas. Building
for a specific context — even a smaller audience — gives you users who
are deeply engaged because the tool actually works for their situation.

2. Privacy matters more than people admit.
All ToolForge calculations happen in the browser. No data is sent to any
server. Users don't have to worry about their salary, CGPA, or tax info
being stored anywhere. This was a deliberate design choice and users
genuinely appreciate it.

3. SEO for specific audiences is easier.
"CGPA calculator" is a competitive keyword globally. "CGPA calculator
Pakistan HEC scale" is almost entirely uncontested. Building for a specific
audience means you rank faster with less effort.

The Stack

  • Next.js 14 App Router with TypeScript
  • Tailwind CSS for all styling
  • Vercel for deployment
  • Google Gemini API for AI-powered tools (with key rotation)
  • All calculations run client-side — zero database The full toolkit is live at freetoolforge.org — 50+ free tools, no signup, no ads. I'd love feedback from Pakistani developers and students on what to build next.

What country-specific tools have you built or wished existed?

WORD COUNT: ~820 words
ESTIMATED READ TIME: 5 min

Top comments (0)