Logo
GPA CALCULATOR

GPA Calculator Help Guide

Learn how to manage your academic data and calculate your GPA effectively

🚀 Getting Started

Welcome to the GPA Calculator! This application helps you track your academic performance by organizing your courses into semesters and calculating your GPA automatically.

First Time Setup: Start by configuring your grading scale in the Settings page, then add your first semester.

📚 Managing Semesters

Creating a New Semester

  1. Navigate to the main Dashboard page
  2. Scroll to the bottom and click the Add New Semester button
  3. Fill in the semester details:
    • Semester Name: Give your semester a descriptive name (e.g., "Fall 2024", "Spring 2025")
    • Weight: Set the weight for this semester in your overall GPA calculation (default is 1)
  4. Click Submit to create the semester

Editing a Semester

  • Find the semester you want to edit on the Dashboard
  • Click the edit icon (✏️) next to the semester name
  • Update the semester name or weight as needed
  • Click Submit to save changes

Deleting a Semester

  • Click the delete icon (🗑️) next to the semester you want to remove
  • Confirm the deletion in the popup dialog
  • Warning: This action cannot be undone and will delete all modules in that semester

📖 Managing Modules/Courses

Adding a New Module

Method 1: Manual Module Entry

  1. Navigate to the semester where you want to add a module
  2. Click the Add New Module button at the bottom of the semester section
  3. A new module row will appear with default values
  4. Click on each field to edit:
    • Module Name: Enter the course name or code
    • Grade: Select your grade from the dropdown (A+, A, A-, B+, B, etc.)
    • Credit: Enter the number of credits for this course
  5. Changes are saved automatically when you move to the next field

Method 2: Using Default Module List

  1. Look for the Choose Default Semester button in your semester section
  2. Click this button to open a list of pre-configured semester templates
  3. Select a default semester that matches your academic program or field of study
  4. The system will automatically populate modules with:
    • Standard module names for that semester/program
    • Default credit values
    • Placeholder grades that you can edit later
  5. After creation, you can edit any module details as needed

Tip: Using default semester templates saves time and ensures you don't miss any required courses for your program.

Editing Module Information

  • Click directly on any module field (name, grade, or credit) to edit it
  • For grades, use the dropdown menu to select the appropriate grade
  • For credits, enter a numerical value
  • Changes are automatically saved when you click elsewhere or press Enter
  • Use the ✓ (checkmark) button to confirm changes or ✗ (cross) to reset

Deleting a Module

  • Find the module you want to delete in the table
  • Click the delete icon (🗑️) in the module row
  • The module will be removed immediately

📊 Understanding GPA Calculations

How GPA is Calculated

The application calculates two types of GPA:

  • SGPA (Semester GPA): Calculated for each individual semester using the formula:
    • SGPA = (Sum of Grade Points × Credits) ÷ Total Credits
  • Overall GPA: Calculated using weighted averages of all semesters:
    • Overall GPA = (Sum of SGPA × Semester Weight) ÷ Total Weight

Semester Weights

  • Each semester has a weight that affects your overall GPA calculation
  • Default weight is 1, but you can adjust it based on your institution's requirements
  • Higher weight means the semester has more impact on your overall GPA
  • You can edit weights in the Settings page or when creating/editing semesters

Important: Managing Empty Semesters

For Accurate GPA Results: Remove semesters that have no modules or only modules without grades.

  • Empty semesters (those without any modules) can affect your GPA calculation
  • Semesters with modules that have no grades assigned will also impact results
  • To get correct GPA calculations:
    • Delete empty semesters using the delete icon (🗑️)
    • Ensure all modules in active semesters have grades assigned
    • Add modules with actual grades to get meaningful GPA results
  • Only keep semesters that have completed modules with final grades

⚙️ Configuring Settings

Setting Up Your Grading Scale

  1. Navigate to Settings from the sidebar
  2. Configure the point values for each grade (A+, A, A-, B+, B, etc.)
  3. Enter the numerical point value for each grade according to your institution's scale
  4. Common scales:
    • 4.0 Scale: A+ = 4.0, A = 4.0, A- = 3.7, B+ = 3.3, etc.
    • 5.0 Scale: A+ = 5.0, A = 4.0, B = 3.0, etc.
  5. Click Save Changes to apply your grading scale

Adjusting Semester Weights

  • In the Settings page, you'll see all your semesters listed
  • Each semester has an editable weight field
  • Modify the weight values as needed for your GPA calculation
  • Changes are saved automatically

💡 Tips and Best Practices

Organization Tips

  • Use clear, descriptive semester names
  • Enter module codes along with names for easy identification
  • Update your data regularly as grades become available
  • Double-check your grading scale matches your institution's

Accuracy Tips

  • Verify credit values for each course
  • Ensure grades are entered correctly
  • Review calculated SGPA values for reasonableness
  • Keep track of any special grading policies

🔧 Troubleshooting

GPA shows as 0.0000 or NaN

This usually means no valid grades are entered. Check that:

  • Modules have grades assigned (not just "N/A" or blank)
  • Credit values are greater than 0 and properly formatted
  • Your grading scale is properly configured in Settings
  • At least one semester contains valid modules with grades

Changes not saving or buttons not responding

If you see loading spinners or buttons become unresponsive:

  • Wait for the current operation to complete (look for loading indicators)
  • Avoid clicking submit buttons multiple times
  • Check your internet connection and try again
  • Ensure you're properly logged in with Google authentication
  • Refresh the page if operations seem stuck

Form validation errors

If you encounter validation messages:

  • Module names cannot be empty
  • Credit values must be positive numbers (use decimal notation like 3.0)
  • Grades must be selected from the dropdown (A+, A, A-, etc.)
  • Semester names must be at least 1 character long

Can't see my data or login issues

Authentication and data visibility issues:

  • Ensure you're logged in with the correct Google account
  • Data is tied to your specific email address
  • Clear browser cache and cookies if you're having login issues
  • Try logging out and logging back in

Loading issues or application freeze

If the app becomes unresponsive:

  • Wait for any loading operations to complete
  • Check browser console for error messages (F12 → Console)
  • Try refreshing the page
  • Ensure you have a stable internet connection
  • Close and reopen the browser tab

Need More Help?

If you're still having trouble or have suggestions for improvement, we'd love to hear from you!

This is an open-source project - feel free to contribute or report issues.

Remember to back up your data and keep track of your academic records independently.