📖 Documentation

📘 How to Use GradePath

Getting Started

GradePath is designed to be intuitive — a first-time user should go from landing on the page to seeing a correct SGPA in under 60 seconds. Here's how.

Step 1: Select Your Grading Scale

On the Calculator page, the first thing you'll see is a dropdown labeled "Select Scale". Choose your university's grading system from the list of presets:

• VTU (10-point) — CBCS: S=10, A=9, B=8, C=7, D=6, E=5, F=0
• Anna University: O=10, A+=9, A=8, B+=7, B=6, C=5, U=0
• Generic 10-point: O=10, A+=9, A=8, B+=7, B=6, C=5, P=4, F=0

If your university isn't listed, select "— Build Custom Scale —" to define your own grade-label and grade-point pairs (see Step 5 below).

Step 2: Add a Semester

Click the "+ Add Semester" button. A new semester card will appear. You can add as many semesters as you need — each one gets its own card with its own SGPA display.

Step 3: Add Subjects

Inside a semester card, click "+ Add Subject" to add a row. Each subject row has three fields:

• Subject name (optional) — just for your reference
• Credits — the credit value for that subject (e.g. 3, 4, 1.5)
• Grade — select the grade you received from the dropdown

Use the ✕ button on any row to remove a subject.

Step 4: Watch Results Update Live

There's no "Calculate" button. As soon as you fill in credits and select a grade, the SGPA for that semester updates automatically. The overall CGPA at the bottom updates across all your semesters as you add or change data.

Step 5: Build a Custom Scale (if needed)

Select "— Build Custom Scale —" from the scale dropdown. A builder panel will appear where you can:

1. Add grade-label and grade-point pairs (e.g. "A+" → 9, "B" → 7)
2. Click "💾 Save Scale" and give it a name
3. Your custom scale is now available in the dropdown, just like a preset

Step 6: Remove or Edit

You can remove individual subjects with the ✕ button, or remove an entire semester using the "Remove Semester" button in its header. All calculations update instantly.

Keyboard & Mobile Tips

• Tap targets are at least 44px — comfortable for mobile use
• Subject rows wrap vertically on small screens — no horizontal scrolling needed
• Your data auto-saves via localStorage — refreshing the page won't lose it

🔒 Privacy Policy

GradePath takes your privacy seriously. This policy explains what data we collect, how it's used, and your rights.

Information We Collect

We collect nothing. GradePath is a fully static, client-side web application. There are no servers, no databases, no analytics trackers, and no cookies (except localStorage, which stays entirely on your device).

• We do not collect your name, email, or any personal information
• We do not collect your grades, subject names, or academic data
• We do not use cookies or tracking scripts
• We do not have access to your data — it never leaves your browser

Local Storage

GradePath uses your browser's localStorage API to save your entered data (grading scale selection, custom scales, semesters, subjects) so it persists across page refreshes. This data:

• Stays on your device only — it is never transmitted anywhere
• Can be cleared at any time by clearing your browser's site data
• Is not accessible by any other website or third party

Third-Party Services

GradePath does not integrate with any third-party services, APIs, or external resources (other than standard web fonts from the system font stack). If hosted on GitHub Pages, Netlify, or similar static hosts, those platforms may have their own logging practices — refer to their respective privacy policies for details.

Changes to This Policy

If this policy changes in the future, the "Last updated" date at the top will be revised. Since GradePath collects no data, changes are likely to be minimal or procedural.

Contact

If you have questions about this privacy policy, reach out via the Contact page.

🤝 Community Guidelines

GradePath is built for students, by a student. While the tool itself doesn't have forums or user-generated content (yet), these guidelines apply to interactions through GitHub issues, feature requests, and any future community spaces.

Be Respectful

Treat everyone with respect. Disagreements are fine — personal attacks, harassment, and hate speech are not. This is a small project built for learning and helping fellow students.

Be Constructive

When reporting a bug or suggesting a feature, include as much context as possible:

• What grading scale you were using
• What values you entered (or a screenshot with sensitive info redacted)
• What result you expected vs. what you got
• Your browser and device (helpful but not required)

No Spam or Self-Promotion

GitHub issues and discussions are for improving GradePath. Please don't use them for advertising, link dropping, or any form of spam.

Privacy Matters

When sharing screenshots or examples (e.g. in a bug report), do not include personal information — redact your name, student ID, university name, or any other identifiers. GradePath itself doesn't collect this data, and we want to keep it that way.

Be Patient

GradePath is maintained by a single student (Poorvith M P). Responses to issues and feature requests may take time. Contributions and constructive feedback are welcome and appreciated, but please be understanding of the maintainer's bandwidth.

Contributing

Interested in contributing? The project is open-source. Feel free to:

• Open a GitHub issue with your idea or bug report
• Submit a pull request with improvements
• Suggest new grading scale presets (include citation/source)

By contributing, you agree that your contributions will be licensed under the same terms as the project (MIT License).