Attendance

No Class Selected

Please select a role and class from the dropdown above to begin marking attendance.

Calendar

Sun
Mon
Tue
Wed
Thu
Fri
Sat

Reports

Attendance Report

No Data Yet

Add students and mark attendance to see reports.

Report History

No Reports Generated

Exported reports will appear here.

Data Management

Import student data using any of the methods below. Required fields: Name, Class. Optional: Student ID, Gender.
File Upload
Drop file here or click to browse
Supports JSON, XLSX, CSV
Paste Data
First row should be headers. Columns: name, class, studentId, gender
Manual Entry
Quick Batch — Enter one student per line (name,class)
Import App Data

Import a full app data backup (JSON) previously exported from ClassReg. This will replace all current data.

Export App Data

Export all app data (students, attendance records, settings) as a JSON file. This can be imported back into ClassReg or manually added to GitHub.

Loading...
Export Students CSV

Export student list to CSV or Excel format.

Export Attendance

Export attendance records for a specific class and date range.

GitHub Pages Guide
Hosting on GitHub Pages:
1. Export app-data.json
2. Place both index.html and app-data.json in your repo root
3. Enable GitHub Pages in repo Settings
4. The app will auto-load data from app-data.json
GitHub Sync Workflow
Current Local State
Loading...
Daily Workflow
  1. Mark attendance in the Attendance tab and save
  2. Click Download app-data.json above
  3. Go to your GitHub repo and replace the existing app-data.json
  4. Next session: the app loads from localStorage (your changes are already there)
  5. On a new device: open the app, click Merge from GitHub backup below to pull in any missing records
JSON Structure Reference
{
  "students": [
    { "id": "abc123", "name": "John Smith", "class": "4A", "gender": "M", "studentId": "..." }
  ],
  "attendance": {
    "2025-03-12|form|4A": {           // Form class key: date|form|class
      "type": "form", "class": "4A", "date": "2025-03-12",
      "records": {
        "AM": { "abc123": "P", "def456": "A" },
        "PM": { "abc123": "P", "def456": "SA" }
      }
    },
    "2025-03-12|subject|5B|Chemistry": {   // Subject key: date|subject|class|name
      "type": "subject", "subject": "Chemistry", "class": "5B", "date": "2025-03-12",
      "records": { "abc123": "P", "def456": "SB" }
    }
  }
}
Each attendance key is unique per day + class + subject. Adding new days to the JSON never overwrites old records. The exported file is always the complete cumulative dataset — just replace the GitHub file each time.
Merge from GitHub Backup

Load an app-data.json from GitHub and merge its attendance records into your local data. Your local records always take priority — only missing records are added. Use this when switching devices or after manually editing the GitHub file.

No Students

Add students using the Upload/Import tab.

Settings

Attendance Statuses
Teacher & Classes
UI Preferences
Dark Light
A A
Data Management
Export your data before clearing. Data is stored in browser localStorage.
About ClassReg
ClassReg v1.0
Digital Class Register for CSEC/CAPE Teachers
Supports Form Class (AM/PM) and Subject Classes
Offline-capable · GitHub Pages compatible