Thanks for wanting to help improve GradeForge. Whether you're adding a grading preset for your university, fixing a math edge case, or tweaking the UI, contributions are welcome.
- Adding university grading schemes: If your college or university uses a specific grading scale, you can add it to
src/constants/presets.ts. Make sure to link the official university regulation document in your PR description so we can verify the grade points. - Bug fixes & edge cases: Handling strange credit combinations, rounding mismatches, or layout glitches on mobile.
- Feature improvements: Suggesting useful tools for students (like better export options or formula explainers).
- Fork the repository and clone your fork:
git clone https://github.com/your-username/gradeforge.git cd gradeforge - Install dependencies:
npm install
- Run the dev server:
npm run dev
- Create a branch for your changes:
git checkout -b feat/add-my-university-scale
- Keep it 100% private: No backend databases, logins, or tracking of student grades. Everything must work client-side in the browser.
- Verify the math: Any new grading scale or formula calculation needs to be verified against the official university syllabus or notification.
- Run the build: Make sure
npm run buildpasses with zero TypeScript and bundling errors before opening a pull request.
- Commit your changes with a clear commit message.
- Push to your fork and open a Pull Request against
main. - Explain what you changed and why, with references if you added new grading schemes.
I review PRs as soon as I can. If you want to discuss an idea before building it, open an issue on GitHub first.