🏪 Lanren Toolkit

📊 Quiz & Assignment Gradebook

Add your class roster and multiple assessment items — quizzes, assignments, whatever you're tracking — then enter each student's scores over time. Get each student's running average and the class average automatically. Data auto-saves in your browser, so it's still there next time you open the page, which matters because you'll likely enter grades across several sessions, not all at once.

Ad・Leaderboard 728×90
Ad・Rectangle 336×280

📖 How to Use

  1. Paste or type student names into the "Add Students" box, one per line, then click "➕ Add Students" to add the whole roster at once.
  2. In "New Assessment Name", type what this assessment is called (e.g. "Quiz 1" or "Homework 1") and set its "Max Score" (defaults to 100), then click "➕ Add Assessment" to add a new column to the table.
  3. The table shows a score field for every student × every assessment. Click a cell and type the score directly — there's no save button, every entry is saved to your browser automatically the moment you type it.
  4. The "Average" column on the right calculates each student's percentage as "total points earned ÷ total points possible" across the assessments they've been graded on. Assessments that haven't been entered yet are not treated as a zero — they're simply skipped until you fill them in.
  5. The bottom row shows the "Class Average" for a quick read on how the whole class is doing on each assessment.
  6. To delete a student or an assessment, click the "✕" next to their row or column header. To start completely fresh, click "🗑️ Clear All Data" (a confirmation dialog appears first, so you won't lose data by accident).
A note on privacy and where your data lives: everything in this tool — the roster, the assessments, the scores — is stored only in this device's browser local storage (localStorage). Nothing is ever uploaded to a server, and it's still there when you refresh the page or come back later. But because it only lives locally, switching to a different computer or browser, or clearing your browser's cache/site data, will permanently delete everything. It's strongly recommended to periodically copy your grades into Excel, Google Sheets, or your school's official grading system as a backup — don't rely on this tool alone as long-term storage for grades that matter.

📖 Deep Dive: What This Gradebook Calculates — and What It Doesn't

How the "Average" is calculated — and why ungraded items don't count as zero

This gradebook uses a points-based weighted percentage: total points earned divided by total points possible, rather than simply averaging each assessment's percentage together. For example, if a student scores 18/20 on a quiz and 90/100 on an assignment, the average comes out to (18+90) ÷ (20+100) = 108 ÷ 120 = 90% — so higher-point assessments naturally carry more weight, which mirrors how most teachers actually calculate a term grade. More importantly, any score field left blank is completely excluded from both the numerator and denominator. That's deliberate: teachers typically enter grades across multiple sessions (Quiz 1 today, Homework 1 a few days later), and if ungraded items were treated as zero, every student's average would look artificially low early in the term and only "correct itself" once everything is entered — a display pattern that easily leads a teacher to misjudge where a student actually stands. This tool's "Average" column is designed to reflect only what's been entered so far.

What the "Class Average" row tells you

The "Class Average" row at the bottom of the table computes a separate average for each assessment column — summing the scores of every student who's been graded on that item and dividing by how many were graded — while the rightmost cell shows the average of every student's overall "Average" percentage. This gives you two quick reads at a glance: whether a particular quiz or assignment ran harder or easier than expected for the class as a whole (a low class average might mean the material or the test itself needs a second look), and which assessment still has incomplete data entered (a column with zero scores entered shows a dash). One thing worth watching: the class average, like the student average, only counts students who've actually been graded — if only half the class has a score entered for a given quiz, that average reflects only that half, not the whole class, so keep entry progress in mind when reading it.

What this gradebook is not: how it differs from a real school system or a cloud spreadsheet

This tool is intentionally lightweight — no login, no server, purely local — which makes it great for quickly jotting down and checking running averages during the term. It is not meant to replace your school's official student information system or gradebook database. The key difference: official systems typically have cloud backup, multi-user access, permission controls, and audit history, so data doesn't disappear just because you switch machines. This tool's data lives entirely in the browser on the device you're using right now — there's no cloud sync at all, so switching devices, switching browsers, or accidentally clearing browsing data will make the entered grades disappear permanently, with no way to recover them. If you're preparing an official grade submission (a term report card, a parent communication log), treat this tool as a day-to-day scratchpad for quick entry and estimation, and always transfer or re-verify the final numbers in your school's official system before submitting.

Worked example: how one student's average is built up across three assessments

Suppose a teacher adds three assessments: "Quiz 1" (max 20), "Homework 1" (max 100), and "Quiz 2" (max 20). One student scores 16 on Quiz 1 and turns in Homework 1 for 85, but is absent for Quiz 2, which is still blank. At this point, that student's average is (16+85) ÷ (20+100) = 101 ÷ 120 ≈ 84.2% — Quiz 2 being blank does not drag this number down at all. Once that student makes up the quiz and a score of 14 is entered, the average instantly recalculates to (16+85+14) ÷ (20+100+20) = 115 ÷ 140 ≈ 82.1% — all without any manual recalculation. The gradebook updates that student's average and the class average automatically the moment the score is typed in.

❓ FAQ

I enter grades in several sessions over time — will my data really still be there?

Yes, as long as you're using the same device and the same browser. Every time you add a student, add an assessment, or type a score, it's saved to your browser's local storage instantly — no "Save" button needed. Come back later on the same browser and URL, and everything is exactly where you left it, ready to continue entering.

If I open this on a different computer or my phone, will the data sync over?

No. This tool has no login and no cloud sync — the data lives entirely in the local storage of the device and browser you're currently using. A different computer, a different phone, or even a different browser on the same computer (say, switching from Chrome to Edge) is a completely separate, isolated environment with no access to the other's data. If you need cross-device access, periodically copy your data into Excel or Google Sheets as a backup.

If I clear my browser's cache or browsing data, will my gradebook disappear?

Yes. This tool's data lives in your browser's localStorage, and clearing "browsing data," "site data," or "cache" in your browser settings will very likely wipe out everything this tool has saved, with no way to recover it. It's strongly recommended to back up anything important by copying it elsewhere (a spreadsheet, a screenshot) rather than relying solely on browser local storage.

Does leaving a score blank count as a zero and drag down a student's average?

No — this is intentional. Any blank score field is completely excluded from both the numerator (points earned) and denominator (points possible) of the "Average" calculation. Only assessments that actually have a score entered are counted, so before you've finished entering everything, the average you see reflects true performance on what's been graded so far — it won't be artificially dragged down just because some items are still ungraded.

Can I change an assessment's max score or name after creating it?

Not directly in the current version. If you set something up incorrectly, delete that column (click the "✕" next to its header) and add a new one with the correct name and max score. Note that deleting a column also permanently deletes any scores already entered under it, so it's worth double-checking the name and max score before adding a new assessment.

Ad・Leaderboard 728×90