1 Manage Your Courses

Use the course controls in the sidebar to organize your subjects:

• Select the current course from the dropdown.
• Set the units for that course (used for GWA).
• Use Add / Rename / Delete to manage multiple courses.
• Open the Dashboard tab to see all courses and your semester GWA.

2 Setup Your Grade Criteria

Normal Components: Add your coursework components like Exercises, Quizzes, Projects, etc.

• Enter the component name (e.g., 'Quizzes')
• Set the weight percentage (e.g., 20%)
• Click 'Add Component'

Examinations: Add your exams like Midterm, Quiz Exam, etc.

• Configure exam settings (Final Exam, Exemption conditions)
• Set passing percentage for exams
• Add each exam with its weight

Important: Make sure the total weight equals 100%!

3 Setup Grade Scale

Define how percentages convert to college grades (e.g., 1.00, 1.25, etc.).

• Use Set Default UP Grade Scale for a quick standard setup.
• Or manually set the minimum percentage for each college grade in the improved table interface.
• Optionally enable rounding so scores like 94.55 are treated as 95 when mapping to a college grade.

Tip: The grade scale table now features a modern design that matches the overall application style!

4 Enter Your Scores

Go to the 'Calculate Grades' tab and input your scores:

• Normal Components: Add multiple scores for each component (e.g., Quiz 1: 45/50, Quiz 2: 38/40)
• Examinations: Add exam scores in the same way
• Use the 'Add Score' button to add each entry - don't forget to click it!
• You can remove scores by selecting rows and clicking 'Remove Selected'
• Uncheck 'Include in calculation' to exclude a component temporarily

Important: The app will warn you if you've entered scores but forgot to click "Add Score". Make sure to add all scores before calculating!

Tip: You can add scores progressively as you complete requirements!

5 Calculate & Analyze

Click the 'Calculate Final Grade' button to see your results:

• View your final percentage and college grade
• See detailed breakdown of all components
• Check exemption eligibility (if applicable)
• View grade projections for incomplete components

6 What If Calculator

Explore different grade scenarios using the What If Calculator:

• Scenario Mode: Add or modify scores for components to see what your final grade would be
• Target Mode: Enter a target final grade and see what scores you need to achieve it
• Compare your current grade with different scenarios side-by-side
• Real-time calculation updates as you add or change scores

Tip: Use this to plan your study strategy! Try different score combinations to see what you need to achieve your target grade.

7 Dashboard & Semester Management

The Dashboard tab provides powerful tools for tracking your academic progress:

• Quick Course Entry: Add courses with just their final grade (non-editable) for quick GWA calculation when you already know the final grade
• Semester Management: Create semesters and organize your courses by academic term
• Overall GWA: See your overall GWA calculated from all courses (regular + quick courses)
• Semester GWA: Track GWA for each semester separately

Tip: Use Quick Course Entry for courses where you already have the final grade and don't want to enter all components from scratch!

8 Save & Load Your Work

Automatic Local Storage: Your work is automatically saved as you use the app!

• All your data (courses, criteria, scores, grade scales, semesters, and quick courses) is automatically saved to your browser's local storage every 5 seconds
• When you return to the app, everything will be restored automatically - no need to reload manually!
• Your theme preference (dark/light mode) is also saved automatically
• Component include/exclude status is remembered per course

Manual Save & Export: Enter a file title in the sidebar and click 'Save Criteria & Scores'

• Saves all your criteria, scores, grade scale, semesters, and quick courses
• Downloaded as a JSON file that you can backup or transfer to another device
• Useful for backing up your work or sharing it between different browsers/computers

Manual Load: Use 'Upload Saved File' to restore your previous work from a JSON file

• All your settings, scores, semesters, and quick courses will be restored
• Perfect for transferring your data to another device or recovering from a backup
• Works seamlessly with the automatic local storage - you can use both together!

Tip: The automatic local storage means you rarely need to manually save - your work is always safe! Use manual save/load when you need to backup or transfer your data.