jacksonrakena/gradekeeper

A free, open-source grade tracking site used by 500+ students at 15+ universities and colleges around the world

Gradekeeper

Try it now: gradekeeper.xyz

API	Client

Gradekeeper is an free, open-source Rust + React web app that simplifies grade tracking and projections for university students across the globe.

This repository holds the TypeScript/React based client. For the Rust/Axum-based API server, see jacksonrakena/gradekeeper-server.

Running a developer environment

You'll need Node 16 and NPM/Yarn installed. This guide will use NPM. You'll also need a Rust compiler that supports the 2021 edition.

Server

First, clone jacksonrakena/gradekeeper-server.

1. Configure the parameters:

You'll need to copy .env.template to .env and fill out the fields.

Field name	Description
DATABASE_URL	A Postgres connection string.
JWT_SECRET	A random string of any length, used to encrypt JWTs.
GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET	Your Google credentials for login. You can get these from the Google Cloud Console.
PERMITTED_REDIRECT_URLS	A list of comma-separated permitted URLs. For example, the production server uses https://app.gradekeeper.xyz. For development, set this to something like http://localhost:5173.

2. Run the API server in release mode.

cargo run --release

Client

First, clone jacksonrakena/gradekeeper.

1. Install dependencies:

npm i

2. Configure the client:

Create a file called .env.local and fill in values as per the below table:

Field name	Description
VITE_API_BASE_URL	The base url of the API server. For development, set this to something like http://localhost:3000.

3. Start the development server:

npm run dev

4. Visit the development server on the address that Vite generates.

Screenshots

Home page:

Copyright

Gradekeeper is copyright © 2022—2024 Jackson Rakena.

gradekeeper's Issues

Frontend issue on the create new course components modal.

Ui is not align and placed properly

Mobile user have to scroll, propose to change to flex column for mobile user for more reliable ux

Can you assign me for this issue? I would like to solve it.

Add Export to CSV Feature

It would be beneficial to have an export to CSV feature that allows users to download their grade data in a CSV format. This feature would help users easily share or analyze their grades outside of the application.

• Add an "Export to CSV" button in the user dashboard.
• Implement a function to convert grade data into CSV format.
• Provide options to export all grades or filtered views.
• Consider compatibility with various spreadsheet applications (e.g., Excel, Google Sheets).