ClassLens · User Guide
HomeRoom
User Guide
Everything your teachers, principals, and district administrators need to get the most out of HomeRoom — from first login to end of day.
HomeRoom is a live classroom management dashboard built specifically for Eastern Kentucky schools. It gives teachers instant control over hall passes, attendance, behavior tracking, and more — all from a single screen. Principals and district administrators see real-time data from every classroom in the building.
🌐
Works in Any Browser
No app to install. Open it in Chrome, Safari, Firefox, or Edge on any device — phone, tablet, laptop, or smartboard.
📊
Data Stays With You
Everything is stored in your school's own Google Sheets account. Your data never leaves your district's Google workspace.
📶
Works Offline
If the internet goes down, the dashboard still loads from cache. Attendance and hall passes sync automatically when connection returns.
🏫
School-Branded
Each school has its own colors and mascot. A Porter teacher sees red and black. A Highland teacher sees blue. It feels like yours.
🚽 Hall Pass
Emma
Liam
Olivia
Noah ⚠
⏱ Students Out
Noah+02:14
🚽 Bathroom · Left 10:15 AM
📋 Attendance
Emma Present
Liam Present
Olivia Absent
Ava Tardy
⏲ Timer
08:42
Reading Time
🪑 Seating Chart
Emma
Liam
Olivia
Noah🚶
Ava⏰
💡
Three access levels
HomeRoom has three tiers: Teachers manage their own classroom, Principals see all classrooms in their building, and District Admins see every school at once. Each person gets their own 4-digit PIN.
HomeRoom uses a simple 4-digit PIN — no username, no password to remember. Teachers can create their own account by tapping "✦ New Here? Create Your Account" on the login screen. Principals and district administrators need a registration code from your ClassLens administrator first.
HomeRoom
Johnson County Schools
1
Open your browser
Go to your school's HomeRoom URL. Bookmark it so you can get back quickly every morning. It works in Chrome, Safari, Firefox, or Edge on any device.
2
Enter your 4-digit PIN
Tap the numbers on the keypad. Your PIN fills in automatically after the 4th digit — no need to press Enter. If you make a mistake, tap ⌫ to delete or ✕ to clear.
3
Dashboard opens automatically
If it's your first time, you'll be asked to confirm your classroom details. After that, your dashboard opens directly every time.
⚠️
Forgot your PIN?
Tap "Forgot PIN?" below the keypad. You'll be asked to enter your name, then answer your security question, then choose a new PIN. Make sure you've set up a security question in Settings first.
✦
New teacher? Create your own account
Tap "✦ New Here? Create Your Account" on the login screen. Enter your name, select your school, choose a 4-digit PIN, and set a security question. You're set up in under two minutes — no IT department needed.
Principals and district admins need a registration code from your ClassLens administrator before they can register.
Attendance is one tap per student. HomeRoom auto-saves to Google Sheets 3 seconds after your last change — no Save button needed.
1
Find the student in the Attendance card
Your full roster is listed. The summary bar at the top shows current Present / Absent / Tardy counts.
2
Tap the correct status
✓ Present — green. ✗ Absent — red. T Tardy — yellow. Tap the same button again to unmark. Tap a different button to change status.
3
Add a tardy note (optional)
When you mark a student Tardy, a note window pops up automatically. Select the reason type (Tardy arrival, Parent pickup, Bus issue, etc.) and add any notes. Tap Save Note.
💡
Mark all present at once
Tap the ✓ All Present button at the top right of the attendance card to mark every student present instantly. Then just unmark the absent ones. Much faster on a full day.
The seating chart gives you a visual grid of every desk in your classroom. Color tells you everything at a glance.
🟢
Green border — Present
Student is in class and marked present.
🔴
Red border — Absent
Student is absent today. Seat appears faded.
🟡
Yellow border — Tardy
Student arrived late. Tardy note may be attached.
🟣
Purple dot — Out on pass
Student is currently out of the classroom on a hall pass.
💡
Change attendance from the seating chart
You can tap any seat to cycle through attendance statuses (unmarked → present → absent → tardy → unmarked). The seating chart and attendance list stay in sync automatically.
↔️
Adjust columns
Use the columns dropdown in the top right of the seating chart card to change between 3, 4, 5, or 6 columns to match your actual classroom layout.
A large visible countdown timer the whole class can see. Perfect for tests, reading blocks, centers, or any timed activity.
1
Set the time
Tap one of the preset buttons — 5, 10, 15, 20, or 30 minutes. The timer display updates immediately.
2
Add a label (optional)
Tap the label field and type what the timer is for — "Reading Time", "Math Test", "Centers". This label is announced when time is up.
3
Start, pause, or reset
Tap ▶ Start to begin. Tap ⏸ Pause to hold. Tap ↺ to reset back to the starting time. When it hits zero, the timer flashes red and announces "[label] is up!"
Log positive recognition and corrective notes instantly. Every entry is timestamped and saved to Google Sheets, giving you a ready record for parent conferences or IEP documentation.
⚠️
Corrective Notes
Redirected, Disrupting Class, Conduct Note Sent. Logged discreetly, timestamped, saved automatically. No paper needed.
💡
End of Day Summary includes behavior
The End of Day summary (📊 button in the header) shows all behavior notes from the day — positive and corrective — with timestamps. Print it or save it for your records.
Log nurse visits directly from the dashboard. Keeps a running record of how often each student visits the nurse — useful for identifying patterns or supporting medical documentation.
1
Select student and add a note
Choose the student from the dropdown. Optionally add a note — "headache," "stomach," "scraped knee." The note field is optional.
2
Tap "🏥 Log Visit"
The visit is timestamped and saved. It appears in the Nurse Visits card below and is included in the End of Day summary.
⚠️ Use this feature during fire drills, lockdowns, or any emergency requiring an immediate student headcount. Results are logged to Google Sheets instantly and visible to your principal in real time.
1
Tap "🚨 Emergency" in the header
The screen goes full red. Your entire roster appears as a grid of buttons. A counter shows how many students are accounted for.
2
Tap each student as you account for them
Their button turns green. The counter updates in real time. Students NOT tapped remain red — these are potentially unaccounted for.
3
Tap "✓ Submit Headcount"
Your count — including any missing students — is logged to the sheet and visible to administration immediately. The voice reads back the count.
📋
Students already out on passes
If a student is out on a hall pass during an emergency, they will still appear in the emergency grid. Account for them separately — check with the office or nurse about students who were out of the room.
Enable Substitute Mode the night before an absence. When a substitute opens HomeRoom the next day, they'll see your roster, schedule, lunch menu, and your personal notes — ready to go from minute one.
1
Tap "🔄 Sub Mode" in the header
A panel opens. Write notes for your substitute — where things are, what's planned for the day, who to contact, any special instructions.
2
Tap "✓ Enable Sub Mode"
A purple banner appears at the top of the dashboard. Sub Mode is now active.
3
Substitute logs in with your PIN
The sub sees the purple banner, your notes, your roster, and your schedule. They can take attendance and issue passes normally.
4
Disable when you return
When you're back, tap "🔄 Sub Mode" → "✕ Disable Sub Mode" to turn it off.
Tap ⚙️ Settings in the header to open the settings panel. Changes save automatically to Google Sheets.
👤
Classroom Info
Update your name, school, room number, and grade level. These appear in the header and on all reports.
📋
Student Roster
Add or remove students, paste a new list, or sort alphabetically. Changes take effect immediately.
📅
Daily Schedule
Build your schedule using dropdown time selectors (5-minute intervals). The schedule strip at the top of the dashboard highlights the current period automatically.
🔑
Change PIN
Enter a new 4-digit PIN and confirm it. Your new PIN is active immediately.
🔒
PIN Recovery
Set a security question and answer. Used to reset your PIN if you forget it. Pick a question only you would know.
The Admin Dashboard is for principals and district administrators. Open it at /admin.html on your HomeRoom URL. Teachers cannot access this dashboard — their PIN will be rejected.
classlens.live/admin.html
📊 Overview
👥 Roster
📢 Announcements
🍽 Lunch Menu
📅 Schedule
🏫 School View
⚙️ Users & PINs
🏫 School View — Drill-Down Navigation
The School View tab lets principals and district admins drill down from district level all the way to individual classroom detail.
1
District level — all schools
District admins see every school as a card with the school logo, mascot, and live attendance counts. Principals see only their school.
2
School level — all classrooms
Click a school to see every classroom card — teacher name, room number, present/absent/tardy/out counts at a glance.
3
Classroom level — full detail
Click a classroom to see the full picture — every student's attendance status, all hall passes (with whether they returned), behavior notes, and nurse visits for the day.
⚠️
Keep your PIN private
Your PIN gives access to your classroom data. Don't share it with students. If you think your PIN has been compromised, change it immediately in Settings.
Your district administrator will fill in the table below with your school's actual PINs before distributing this guide.
| PIN |
Role |
Name |
School / Room |
Dashboard |
| ____ |
District Admin |
_______________ |
All Schools |
/admin.html |
| ____ |
Principal |
_______________ |
_______________ |
/admin.html |
| ____ |
Principal |
_______________ |
_______________ |
/admin.html |
| ____ |
Teacher |
_______________ |
Room ___ |
/index.html |
| ____ |
Teacher |
_______________ |
Room ___ |
/index.html |
| ____ |
Teacher |
_______________ |
Room ___ |
/index.html |
| ____ |
Teacher |
_______________ |
Room ___ |
/index.html |
| ____ |
Teacher |
_______________ |
Room ___ |
/index.html |
⚡ Quick Reference
Teacher Dashboard URL
________________________/index.html
Admin Dashboard URL
________________________/admin.html
Support Email
support@classlens.live
Forgot PIN?
Tap "Forgot PIN?" on login screen
My dashboard shows the wrong school. What do I do?
Your browser has saved old settings. Open Settings (⚙️), update your school and room number, and tap Save. Or open the dashboard in a private/incognito window to start fresh.
My attendance isn't showing up in the admin dashboard.
The admin overview only shows classrooms that have logged activity today. Make sure at least one student has been marked present, absent, or tardy. The data auto-saves — no need to press anything extra.
The page says "Syncing..." and never finishes.
Check your internet connection. HomeRoom uses Google Apps Script which can occasionally take a few extra seconds on first load. Wait 10-15 seconds and refresh. If it still fails, your network may be blocking Google Scripts — contact your IT coordinator.
Can two teachers use the same PIN?
No — every PIN is unique. If you try to register with a PIN that's already taken, HomeRoom will tell you and ask you to choose a different one.
Can students see the dashboard?
Only if they know a PIN. We recommend not sharing your PIN with students and locking the dashboard (🔒 Lock) when you step away from your desk. The screen locks immediately and requires the PIN to unlock.
How do I add a new teacher to the system?
New teachers can self-register by tapping "✦ New Here? Create Your Account" on the login screen. Teachers don't need a registration code. Principals and district admins do — contact your ClassLens administrator for the code.
Where is my data stored?
All data is stored in your school district's Google Sheets account. ClassLens never has access to your student data. Your district owns it completely.
Does HomeRoom work on a smartboard?
Yes. Open it in the browser on your smartboard and it works perfectly. The large timer and seating chart are especially useful on a big screen where the whole class can see them.
📞 Contact ClassLens Support
Email Support
support@classlens.live
Response Time
Within 1 business day
Product
HomeRoom by ClassLens
Built in
Eastern Kentucky 🏔
When contacting support, include your district name, school name, and a description of the issue. Screenshots are always helpful.