Skip to content

frostjade71/gwa_calculator

Repository files navigation

GWA Calculator Logo GWA CALCULATOR

Next.js React TypeScript GitHub Stars

Built for lazy students

Project Overview

The GWA Calculator helps college students easily track and calculate their General Weighted Average. Built for HCCCI College students and students everywhere, you can quickly calculate your grades for one semester or track your overall academic performance from your phone or computer. Your data stays private and secure since everything is saved directly in your browser, with no need for accounts or cloud storage.

Note: This is a client-side only application - no data is ever sent to any server. Your academic information stays completely private on your device.

Key Features

Core Functionality

  • Dynamic Subject Management - Add and remove subjects with ease
  • Live GWA Calculation - Automatic recalculation as you type
  • Smart Validation - Grade range (1.0-5.0) and units (≥1) validation
  • Show/Hide Results - Toggle GWA results visibility with blur effect
  • Auto-Save - localStorage persistence across sessions
  • Export Options - Download as text file or screenshot (PNG)

Quick Start

Local Development

git clone https://github.com/yourusername/gwa_calculator.git
cd gwa_calculator
npm install
npm run dev

Access the application:

With Docker (Recommended)

docker build -t gwa-calculator .
docker run -p 3000:3000 gwa-calculator

Access the application:

Technology Stack

🧮 GWA Formula

The calculator uses the standard weighted average formula:

For each subject:
  weightedGrade = grade × units

GWA = (sum of all weightedGrade) / (sum of all units)

Example:

  • Math: 1.6 (3 units) → weighted = 4.8
  • English: 2.0 (3 units) → weighted = 6.0
  • GWA = (4.8 + 6.0) / (3 + 3) = 1.80

Docker Development

docker-compose -f docker-compose.dev.yml up

Developer

Jaderby Peñaranda

Website Email


Version: 1.0.0
Last Updated: December 14, 2025

🚀 Next Update

For upcoming features, check out What's Next.md.

About

GWA Calculator helps college students easily track and calculate their General Weighted Average

Topics

Resources

Stars

Watchers

Forks

Contributors