An intelligent Hostel Authentication and Notification System (HANS) designed to streamline hostel management through secure authentication, digital leave management, QR-based verification, geofencing, and real-time notifications.
The application enables seamless communication between Students, Parents, Wardens, and Security Guards, providing a secure and efficient hostel management experience.
🚀 Status: Deployed on AWS Cloud
🏪 App Store: Available (https://apps.apple.com/in/app/hansapp/id6759252267)
🌐 Backend: Hosted on AWS
HANS is a full-stack mobile application that digitizes hostel operations by replacing manual processes with an automated and secure workflow.
The system supports multiple user roles with dedicated dashboards and ensures transparency throughout the leave approval and hostel entry/exit process.
- Student Login
- Parent Login
- Warden Login
- Guard Login
- Role-Based Access Control
- View Profile
- Apply for Leave
- View Leave Status
- Generate QR Code
- Hostel Entry & Exit Tracking
- Receive Notifications
- View Student Details
- Approve/Reject Leave Requests
- Track Student Leave Status
- Receive Notifications
- Manage Leave Requests
- Approve/Reject Applications
- Monitor Hostel Records
- View Student Information
- Notification Management
- Location-based hostel verification
- Secure campus boundary detection
- Prevent unauthorized check-ins
- Leave Status Updates
- Parent Notifications
- Warden Notifications
- Student Alerts
- Dynamic QR Code Generation
- Secure Hostel Verification
- Fast Student Check-In/Check-Out
Mobile App (React Native + Expo)
│
│
┌──────────────┴──────────────┐
│ │
Authentication API Notification Service
│ │
└──────────────┬──────────────┘
│
PHP Backend APIs
│
│
MySQL Database
│
AWS Cloud Server
- React Native
- Expo
- TypeScript
- PHP
- REST API
- MySQL
- AWS Cloud
- XAMPP
- phpMyAdmin
- Android Studio
- Expo CLI
HANS/
│
├── frontend/
│ ├── app/
│ ├── assets/
│ ├── components/
│ ├── config/
│ ├── constants/
│ ├── hooks/
│ ├── services/
│ ├── translations/
│ ├── utils/
│ ├── package.json
│ ├── app.json
│ └── eas.json
│
├── backend/
│ ├── api/
│ ├── assets/
│ ├── config/
│ ├── helpers/
│ ├── config.php
│ └── package.json
│
├── screenshots/
│
├── README.md
└── LICENSE
- Node.js
- Expo CLI
- PHP
- MySQL
- XAMPP
- Android Studio (optional)
git clone https://github.com/yourusername/HANS.gitcd frontend
npm installnpx expo start- Copy the backend folder into your PHP server directory (e.g., XAMPP
htdocs) or configure it on your preferred web server. - Update the backend configuration with your own MySQL database credentials.
- Start Apache and MySQL.
The production database is securely hosted on AWS and is not included in this repository.
To run the project locally:
- Create your own MySQL database.
- Configure the database connection in the backend.
- Import your own schema if required.
Sensitive information such as:
- Database credentials
- AWS configuration
- API keys
- Environment variables
has been excluded from this repository.
- Face Recognition Authentication
- Push Notifications
- AI-based Leave Approval Assistant
- Hostel Attendance Analytics
- Visitor Management
- Admin Dashboard
- 📱 Cross-platform Mobile Application
- 🔐 Secure Authentication System
- ☁ AWS Cloud Deployment
- 📷 QR Code-Based Verification
- 📍 Geofencing Support
- 🔔 Real-Time Notifications
- 👥 Multi-Role User Management
- 🌐 RESTful API Integration
Muskan Dewangan Anamika Ritesh Kumar Nayak Kashifa Fatima Sejal Choudhari Tantresh Kumar Sahu Abhineet Shrivastava Rajat Kumar Verma
B.Tech – Computer Science Engineering (AI/ML)
- Artificial Intelligence
- Machine Learning
- Deep Learning
- Full-Stack Development
- Cloud Computing
- Mobile Application Development
Contributions, suggestions, and feature requests are welcome.
- Fork the repository
- Create a feature branch
- Commit your changes
- Open a Pull Request
This project is licensed under the MIT License.
If you found this project helpful, consider giving it a ⭐ on GitHub!