Academic Tracker

Academic Tracker gives students a clear, data-driven view of their academic progress. Add terms, subjects, and grade results to see live GPA calculations, dashboard charts, and AI-generated recommendations. The tracker is available to every signed-in RoxWhy user at /app/academic-tracker.

Getting started

1. Create a term

Open Academic Tracker from the app header. On first visit, create a term or semester to hold your subjects and grades.

• Click Add term and enter a name (for example "Semester 1 2025").
• Select the term whenever you want to view or add data for that period.
• You can create, edit, and delete terms at any time from the term selector.

2. Add subjects

With a term selected, add the subjects you want to track.

• Click Add subject and fill in the name, category, and any optional details (teacher, colour, or target grade).
• Each subject belongs to the current term.
• You can edit or delete a subject from its subject card.

3. Add grades

Open a subject and add individual grade entries.

• Fill in the assessment name, score, maximum score, date, type, and optional weighting.
• RoxWhy calculates the letter grade and GPA points for each entry automatically.
• Edit or delete any grade entry from the assessment list inside the subject.

When grades change, all dashboard charts, GPA figures, and category summaries update immediately.

Import a report

Instead of typing results in one by one, upload a school report and let AI extract the grades for you. Open the Academic Tracker and use the Import your school report card at the top of the page — if you have dismissed the card, an Import report button stays pinned in the same spot.

• Supported files — PDF, JPG, PNG, WebP, or DOCX, up to 10 MB (PDFs up to 20 pages).
• Model choice — pick a fast or smart model before the import runs. Each option shows a credit estimate, and the actual cost is deducted from your AI-token credits.
• Review before saving — nothing is written until you confirm. The review screen shows every extracted result: conflicts with existing grades default to keeping your existing values, exact duplicates are skipped, and every score, subject mapping, and term is editable before you save.
• Pending imports expire — an import left unconfirmed is discarded automatically after 7 days.
• Undo — after saving, you can undo the import to restore your tracker to how it was. Undo removes the imported data but does not refund the credits used.

Grading scales

Presets

RoxWhy includes several built-in grading-scale presets covering common letter-grade and point-based systems. Select a preset from Settings (/app/academic-tracker/settings) to apply it across all subjects in the tracker.

Custom grading scales

If the preset does not match your school, create a custom scale:

1. Go to /app/academic-tracker/settings.
2. Select Custom and add your own letter-to-percent or letter-to-point mappings.
3. Define each grade band with a letter, a minimum percentage, and a GPA point value.
4. Save the scale.

When you change the active grading scale (preset or custom), RoxWhy automatically recomputes every letter grade and GPA point across all existing entries. No manual re-entry is needed.

What recomputation does

Changing the grading scale recalculates every stored grade against the new mapping. A score that was a B under one scale may become a B+ or an A- under another. Check your subject cards after switching scales to confirm the result is what you expect.

Setting targets

Per-subject target grades

Each subject can have a target grade (for example A or 85%). Set it when you add or edit the subject.

The subject card shows whether you are on track, below target, or above target based on your current weighted average for that subject.

Overall target GPA

Set an overall GPA target in Settings. The dashboard banner compares your current cumulative GPA to the target and shows the gap.

Dashboard

The Academic Tracker dashboard provides several views of your grade data for the selected term.

Grade distribution chart

A bar or pie chart showing how your grades are distributed across letter-grade bands (A, B, C, and so on) for the selected term. Use this to spot whether most of your results cluster in one band or spread across several.

Term trend chart

A line chart plotting your average grade over time for the selected term, one point per date you recorded grades. Use this to see whether your results are improving, stable, or declining as the term progresses.

Subject matrix

A grid view showing each subject against a set of grade dimensions (for example category, current average, target grade, and gap). Use the subject matrix to compare subjects side by side and identify which ones need the most attention.

Category summary

Subjects are grouped by category (for example Science, Humanities, Languages). The category summary shows the average grade and GPA for each group. Use this to see whether a particular category is dragging or lifting your overall GPA.

Calculation explainer

The calculation explainer panel breaks down exactly how RoxWhy arrived at your current GPA figure. It shows the weight applied to each subject, how letter grades map to GPA points under the active grading scale, and the formula used. Use this panel if a GPA figure looks unexpected.

Subject drill-down

Click a subject card to open the subject detail view.

• Grade list — every individual assessment, with score, letter grade, GPA points, and date.
• Per-subject trend — a line chart showing how your grade in that subject has changed over the assessments you entered, in the order they were recorded. Use this to see whether you are improving within the subject.
• Target gap — how far your current average is from the target grade you set for that subject.

Edit or delete individual grade entries from this view.

AI insights

After adding grades for a term, open AI Insights to generate an analysis.

What the analysis contains

• Overall status — a one-sentence summary of how you are tracking for the term, with a sentiment (positive, neutral, or at-risk) and a confidence level.
• Per-subject analysis — for each subject: an assessment of current standing, a specific recommendation for what to work on, and how urgent it is.
• Strategic actions — a grouped list of recommended next steps:
  • Immediate — actions to take this week.
  • Short-term — actions for the next few weeks.
  • Long-term — habits or preparation to build over the rest of the term.
• Motivational message — a brief encouraging note based on your overall trajectory.

When insights regenerate

Insights are cached once generated. They do not regenerate automatically on every visit. RoxWhy regenerates insights when your grade data changes (a new grade is added, an existing grade is edited or deleted, or the grading scale changes). If you return to the insights panel without any grade changes, you see the previously generated result.

To force a fresh analysis, make any grade change or use the Regenerate button if visible.

Creating a planner goal from an insight

Each strategic action includes a Create goal in planner button. Clicking it opens the Study Planner with the action pre-filled as a new goal. This makes it straightforward to turn a specific AI recommendation into a tracked plan.

See Study Planner for how to generate an AI study plan from the goal once it is created.

Settings

Tracker settings are at /app/academic-tracker/settings.

From settings you can:

• Select or create a grading scale (preset or custom).
• Set the overall target GPA.
• Manage term and subject defaults.

Changes to the grading scale take effect immediately and trigger automatic grade recomputation.