Skip to content

PrudhviRaavi/GradeMate

Repository files navigation

🎓 GradeMate | Your Ultimate Academic Companion

Version Status UI Responsive License

Live Demo


🌟 Overview

GradeMate is a state-of-the-art academic utility designed to help students navigate their grading systems with precision and ease. Built with a focus on Premium UI/UX, Advanced Logic, and Full Responsiveness, GradeMate goes beyond simple calculations to provide intelligent predictions and visual feedback — all without needing an account or internet connection for calculations.


🚀 Key Features

🛠️ Core Toolset

Tool Description
📐 SGPA Calculator Real-time credits and grade point weighted average with instant results and growth chart.
📊 CGPA Calculator Multi-semester cumulative average with dynamic semester-wise tracking.
🔮 Grade Predictor Accounts for AB, RA, and RI attendance scenarios to determine your final grade.
📋 Expected Marks Enter your internals to know the exact end-sem marks needed for your target grade, with visual progress bars.
🎯 Required SGPA Target-based simulator to find the SGPA needed to hit your dream CGPA.
🔢 CGPA to % Instantly convert CGPA to percentage for placements and applications.

💎 Premium Experience Features

Feature Description
✨ Micro-Animations Pop-in, fade-in, and reveal-on-scroll animations for a tactile, responsive feel.
🖼️ Export Reports Export all calculator results as high-quality PNG reports with vibrant colors and precision.
⚡ Smart Navigation Seamless tab redirection from homepage feature cards directly into the active calculator.
📈 GPA Growth Charts Integrated Chart.js visualizations showing semester-wise SGPA trends.
🔧 Custom Grading Fully customizable grade labels and point values, reflected across all calculators.
❓ FAQ Hub Searchable knowledge base answering every academic query.

🎨 Design & UX

  • Glassmorphism UI: Semi-transparent cards, backdrop blur filters, and vibrant mesh gradient backgrounds.
  • Premium Typography: Google Fonts (Outfit, Inter, Pacifico) for a polished, modern look.
  • Fully Responsive: Optimized for all screen sizes — from 320px phones to widescreen desktops.
  • Mobile Navigation: Hamburger menu with animated full-screen dropdown for mobile users.
  • Scrolling Testimonials: Infinite-scroll marquee showcasing real student reviews with pause-on-hover.
  • Contact Section: Functional contact form powered by FormSubmit, with a clean "Get in Touch" info grid.
  • Smart Logic: Auto-recalculates results when grading systems are changed app-wide.
  • Data Persistence: Powered by LocalStorage — your data stays in browser across sessions.

📄 Pages

Page Description
index.html Homepage — Hero, Features, Testimonials, Contact Form, Contact Info
utilities.html All 6 calculators in a tabbed interface
how_to_use.html Complete guide with GPA education, interactive tools, grading reference
useful_links.html Curated student portal links and resources
faq.html Searchable FAQ with accordion answers
disclaimer.html Unofficial tool disclaimer
terms.html Terms and Conditions
credits.html Attribution and open-source acknowledgements

🛠️ Technology Stack

Frontend

  • Structure: Semantic HTML5
  • Styling: Modern CSS3 (Custom Properties, Flexbox, Grid, Keyframe Animations)
  • Logic: Vanilla JavaScript ES6+ — Zero framework dependencies for maximum speed.

Libraries & APIs


🔒 Privacy & Security

Important

Zero Accounts Needed: GradeMate is 100% Client-Side. No databases, no cloud storage, no login. Your academic data is stored only in your browser's local storage and never touches a server.


🤝 Contributing

Contributions are welcome! We have a detailed contributing guide that walks you through every step.

👉 Read the full Contributing Guide →

Quick summary:

  1. Fork the repo → Create a branch → Make your changes → Test on mobile & desktop → Push → Open a PR

Found a bug or have a suggestion?


📜 License

This project is licensed under the MIT License — see the LICENSE file for details.

License: MIT


👨‍💻 Developer

Developed by Prudhvi Raavi | GitHub


Disclaimer: This is an unofficial tool built for educational purposes. Always verify calculations with your official university portal. Not affiliated with Hindustan Institute of Technology and Science.

About

GradeMate is a premium, fully client-side academic toolkit that helps students calculate, predict, and visualize their SGPA/CGPA with smart simulations, growth charts, and zero data tracking - fast, responsive, and privacy-first.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors