max172-hqt / grade-tracker

Grade Tracker

A mobile application to keep track of the grades and provide insights on the current performance. React Native; Native Base; SQLite; TypeScript

To cater to a wider range of users using Android and iOS, this cross-platform applicaton was developed with React Native.

Group 8 Members

• Huy Tran
• Jefferson Verzosa
• Peiwen Zhou

Features

• User can setup their semester courses
• User can create and set up different grade components for a subject and dates (example: 3 quizzes, 2 assignments, 2 exams)
• User can see the list of courses and overall performance (GPA, Letter Grade) for the semester
• User can update and see the grades for each grade component for each course
• User can see the weighted grade on every evaluation item.
• User can sort the list of subjects by the GPA or the subject name
• User can be notified based on the recently added grade
• User can see the remaining marks to achieve to pass the course or achieve a letter grade
• User can see different colours based on the current letter grade (A is green, B is brown...)
• User can put a due dates for grade components to remind themselves
• User can update application preferences such as theme
• Users can export data as CSV/JSON
• Users can import data as CSV/JSON
• Users can delete all their data on the app

Terminology

• Grade components: Could be quizzes, exams, assignments, presentations
• Grade tracker sheet: A sheet which shows all grading components of a subject, along with a grade (can be empty) and a weight (percentage)

Development guide

• Clone the project and install dependencies

npm install

• Start expo development server

npx expo start

• Or you can also run iOS and Android simulator with the following commands. For more information, refer to the Expo documentation and list of available commands on package.json file

npm run ios
npm run android

• Check errors with eslint

npm run lint

• Fix code style errors with prettier

npm run format

• This project also comes with a pre-commit to auto-fix eslint errors on staged file and will prevent you from committing if there are errors that have not been fixed.

grade-tracker's Issues

User can add courses to the current semester

As a user, I want to add courses to my current semester

User can see the average marks needed to pass the course or achieve a letter grade for the remaining of the course

As a user, I want to be able to see the average marks needed to pass the course or achieve a letter grade for the remaining of the course.

User can update application preferences such as theme

As a user, I can update application theme preference.

Users can import data as CSV/JSON

As a user, I want an option to import data from an existing file CSV/JSON.

User can see different colours based on the current letter grade (A is green, B is brown...)

As a user, I want to see a display of different letter grades with their own distint colors.

User can be notified based on the recently added grade

As a user, I want to receive notifications based on newly added grades.

User can put a due dates for grade components to remind themselves

As a user, I want the application to remind due dates to input the grade components.

User can update and see the grades for each grade component for each course

As a user, I can update my grades for each grading components and see them

User can sort the list of subjects by the GPA or the subject name

As a user, I want to have the option to sort the list of subjects either by their GPA or by the subject name.

Users can delete all their data on the app

As a user, I can delete all of my data in the app.

User can see the weighted grade on every evaluation item.

As a user, I want to be able to easily access and review the weighted grades assigned to each evaluation item.

Users can export data as CSV/JSON

As a user, I will have the option to export data into a CSV/JSON file

User can see the list of courses with performance summary and overall performance (GPA, Letter Grade) for the semester

As a user, I can see the list of courses with performance summary and overall performance for the semester

User can create different grade components for a subject

As a user, I can create different grade components for a subject