ScaLEEn

Welcome to ScaLEEn

This app helps you generate bubble answer sheets, scan completed sheets automatically, and analyze the results — no more hand-tallying scores or computing item statistics by hand. Everything below is in the order you'll actually use the app, from your first test to your final report.

Step 1 — Generate Sheet

1. Go to the Generate Sheet tab and fill in your exam title, subject, teacher name, and passing score.
2. Pick the number of items (or type a custom count) and choices per item (A–D or A–E).
3. If any items are essays, performance tasks, or anything that can't be scanned as a bubble, open "Item types & points" and mark those items as Manual / Rubric instead of Multiple Choice — they'll print as a blank slot instead of bubbles, and you'll enter those scores by hand later on the Students tab.
4. Choose Roll No digits (2–5) based on how many students you have across your whole school — this is what lets scanning auto-match a sheet to the right student.
5. Pick how many sheets to print per page (1, 2, 4, 6, or 8) depending on how many copies you need and how much paper you want to use.
6. Click Print blank sheet to get physical copies ready for your class.

Step 2 — Answer Key

1. Go to the Answer Key tab and click the bubble that matches the correct answer for each item — or click "⬇ Download template" next to the upload button, fill it in, and upload it instead of clicking through each item by hand.
2. Optionally tag each item's learning competency and Bloom's Taxonomy domain — or upload a Table of Specifications (TOS) to fill both in automatically (a downloadable TOS template is available there too).
3. Click "Save current key" so you can reload the exact same key later — useful if you're grading late submissions or rechecking after the fact.

Step 3 — Students

This tab has three parts — Class Roster, Scan / Import, and Results — switch between them using the small tabs near the top.

1. Under Class Roster: build your class list once — add students one at a time, or click "⬇ Template" to download a class-list spreadsheet, fill it in, and upload it instead. Each student automatically gets an ID number starting from #1 within their own section — or type in a specific number yourself if your school already assigns official IDs (leave it blank for auto-numbering). Since numbering restarts at #1 per section, removing a section never leaves gaps in another section's numbers.
2. If two sections both happen to have the same Roll No. (e.g., both have a "#1"), scanning will still work — it just can't guess which section a sheet belongs to on its own in that specific case, so it'll ask you to pick the right student manually instead of risking a wrong match.
3. Need the same roll number for a student in every subject, school-wide? Fill in the ID column on one master class-list file, and have every teacher import that same file — since the number is explicitly provided, it stays identical everywhere it's imported.
4. Made a typo, or need to correct a student's name or number afterward? Click the pencil (✎) icon next to their name to edit it in place — no need to delete and re-add.
5. Share the ID list with your class beforehand (use "Export ID list") so students know their number and shade it in themselves before the test — this is what makes batch scanning able to automatically match each sheet to the right name.
6. Under Scan / Import: upload a photo (or several at once for a batch, or a multi-page PDF), then either click "✨ Auto-detect corners" or tap the sheet's 4 corner marks yourself in order (top-left → top-right → bottom-right → bottom-left) — a zoomed-in circle follows your tap to help you land exactly on each mark, since that precision is what keeps detected answers correctly lined up.
7. If many answers come back unclear all at once after detecting, a warning banner will point this out and suggest clicking "↺ Re-calibrate" to try tapping the corners again — this is almost always a corner-alignment issue, not the student's actual marks.
8. Click "Detect shaded answers." If the student's Roll No. was read successfully, a green banner confirms exactly who it matched to — you generally won't need to pick the student manually at all. Anything the detector isn't confident about (including an unclear ID) gets flagged for you to check before saving.
9. Click "⬇ Download checked sheet" to get a copy of the student's own photo marked up with ✓ for correct and ✗ (with the right answer shown next to it) for wrong, plus the score — ready to send back to the student. This uses whatever answers are currently shown, so review and fix anything flagged first if you want the marks to reflect your corrections.
10. Have a learner who's genuinely exempted from a specific test (not just absent)? Select their section and name, then click "🚫 Mark selected student as exempted" instead of scanning — no photo needed. They'll still show in Results labeled "Exempted," but won't count toward Takers, MPS, or the class average, so those numbers stay accurate to only the learners who actually took the test. "↺ Undo" reverses this if clicked by mistake.
11. Answer sheet lost or damaged after the fact, but you still know the student's total score? Select their section and name, then click "📝 Enter score manually" — this counts toward Takers, MPS, and the class average like a normal result, but (since there's no sheet to analyze) it won't contribute to item-level analysis — difficulty, discrimination, or KR-20 — for individual questions. "✎ Edit score" lets you correct the number later if needed.
12. If a test has manual/rubric items, a "Manual / rubric scores" section appears automatically — enter each student's points there before saving.
13. Already have scores from ZipGrade, EvalBee, or a spreadsheet? Import those directly instead of scanning — also under Scan / Import.
14. Under Results: see everyone scanned or imported so far for this roster.

Step 4 — Analysis

1. Review scores, item-by-item analysis, mastery levels, and which learning competencies were most/least learned by the class.
2. Filter by section, subject, term, or type of test to narrow down what you're looking at.
3. Need to give bonus points (recitation, attendance, etc.)? Enter them in the Bonus column on the Students → Results table — this lifts the score, percentage, and MPS shown here and in exports, but never affects item analysis, KR-20, or which competencies show as least-learned, since those are always based purely on how each item was actually answered.
4. A "⚠ N to check" badge next to a student's name on the Results table means some of their answers were unclear when scanned — click it (or sort by "Needs review first") to jump straight to those items and quickly confirm whether the scan read them correctly, without having to open every student one by one.
5. Export a full report as Word, PDF, or Excel, already formatted with your school's letterhead and signature blocks.

Step 5 — Intervention (optional)

1. See which competencies the class struggled with most, and which specific students need extra help on each one.
2. Generate ready-made documents: an Action Plan, a one-page proposal, a remediation attendance sheet, or an accomplishment report — all pre-filled with your actual class data.

Keeping your data safe

• Your data autosaves automatically to this browser as you work — no need to manually save.
• That autosave only lives on this one device/browser. Use Export backup periodically (top bar) to download a portable copy, or sign in with Cloud Sync to keep it synced across your phone and laptop automatically.
• Clear saved data permanently erases everything on this device — make sure you've exported a backup first if you might need it again.

Everything here is free right now

Generating sheets, scanning, answer keys, rosters, Item Analysis exports, and Cloud Sync — all of it, with no limits, no keys to enter.

About

ScaLEEn was built by Lyndel E. Esperanza for classroom use. Questions or feedback: LyndelEsperanza@gmail.com