Skip to content

Bjorn99/spga-calculator

Repository files navigation

🎓 SGPA/CGPA Calculator

What Sorcery Is This?

Born from the mystical realms of academia, this calculator transmutes your raw course grades into the sacred numbers known as SGPA and CGPA. Like Gandalf's staff illuminating the darkness, it brings clarity to the complex calculations of academic performance.

Realms Where This Magic Works Best

Primarily crafted for the lands of:

  • India (where the 10-point scale rules supreme)
  • Engineering colleges under AICTE guidelines
  • Universities following the UGC grading system

Powers It Possesses

  • Calculates SGPA with the precision of Elvish craftsmen
  • Forges CGPA across multiple semesters
  • Converts GPAs to percentages (using the legendary 9.5 multiplier)
  • Switches between light and dark themes like day and night in Lothlórien
  • Shows proper grade points (O=10 to F=0) like ancient runes of knowledge

🚫 What It Cannot Do

  • Cannot predict future grades (we're calculators, not Palantírs)
  • Won't hack into university systems to change grades
  • Cannot convert grades from other realms (US 4.0 scale, UK's First Class system)
  • Won't write your assignments (that's your quest to bear)

Begin Your Journey

# Clone this repository like borrowing the One Ring
git clone https://github.com/Bjorn99/sgpa-calculator.git

# Enter the realm
cd sgpa-calculator

# Summon the dependencies
npm install

# Light the beacons (start local server)
npm run dev

Deploy Your Own Instance

Using Netlify

  1. Fork the repository
  2. Connect to Netlify
  3. Deploy settings:
    Build command: npm run build
    Publish directory: dist
    

Join the Fellowship

Found a bug? Have an idea? Join our fellowship!

  1. Fork the repository (like creating your own ring)
  2. Create your feature branch
  3. Commit your changes
  4. Open a Pull Request

📜 License

GNU Affero General Public License v3.0 - Free as the peoples of Middle-earth


"One Calculator to grade them all,
One Algorithm to find them,
One Formula to bring them all,
and in the transcript bind them."