Skip to content

Hostel Guard – A smart hostel attendance system using live selfie verification and geo-fencing to replace manual registers.

Notifications You must be signed in to change notification settings

Abish-13/Hostel-Management-System-

Repository files navigation

🏠 Hostel Guard

Hostel Guard is a smart, digital hostel attendance system designed to replace chaotic manual registers with a secure, verifiable, and location-aware solution.

This project was inspired by a real hostel problem where students had to rush daily to mark attendance in a physical register—leading to confusion, inefficiency, and lack of verification.


🚀 Live Demo

🔗 https://zingy-marzipan-04d4dd.netlify.app


💡 Problem Statement

Traditional hostel attendance systems:

  • Are chaotic and uncomfortable
  • Have no identity or location verification
  • Waste time for students and wardens
  • Are prone to proxy attendance

Hostel Guard solves this using technology that verifies:

  • Who is marking attendance
  • Where they are marking attendance
  • When attendance is allowed

✨ Key Features

👨‍🎓 Student Side

  • Secure registration with hostel, block & room selection
  • Initial face capture for identity binding
  • Time-bound attendance window
  • Live selfie capture (no gallery upload)
  • Real-time GPS location validation
  • Attendance blocked if:
    • Outside hostel premises
    • Time window closed
    • Attendance already marked

🛡️ Admin / Warden Side

  • Create & manage hostels, blocks, rooms & beds
  • Set hostel geo-fence (latitude, longitude & radius)
  • Define attendance timings
  • View attendance:
    • Room-wise
    • Block-wise
    • Chronological order
  • See present & absent students clearly
  • Filter by room number or block
  • Remove or manage registered students

🔐 Security & Verification Logic

  • Geo-fencing: Attendance allowed only inside hostel radius
  • Live selfie capture: Prevents proxy attendance
  • Face matching (conceptual): Ensures same registered user
  • Time restriction: Attendance only during admin-defined window
  • One-entry rule: No duplicate attendance

🧠 Concepts Used

  • Frontend system design (React)
  • Role-based access (Admin / Student)
  • Location-based validation (GPS)
  • Face detection & liveness concepts
  • Real-world UX problem solving
  • Mobile-first responsive UI

🛠 Tech Stack

  • Frontend: React.js, JavaScript, HTML, CSS
  • Deployment: Netlify
  • Design: Mobile-first UX approach
  • Architecture: LMS-style role-based system

📸 Future Enhancements

  • Backend integration (Node.js / Firebase)
  • Actual face recognition API
  • Attendance export (CSV / PDF)
  • Admin analytics dashboard
  • Notification system
  • Multi-hostel support

🙌 Why This Project Matters

This is not just a UI project.

It is built by thinking like:

  • A student (ease & fairness)
  • A warden (control & verification)
  • A system designer (security & scalability)

The goal was to solve a real, daily problem using practical technology.


📬 Feedback & Contributions

Feedback, suggestions, and improvements are always welcome.
This project was built to learn, improve, and create real impact.

⭐ If you find this interesting, consider starring the repository!

About

Hostel Guard – A smart hostel attendance system using live selfie verification and geo-fencing to replace manual registers.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages