A production-style MERN-stack hostel operating system built to modernize hostel infrastructure through automation, real-time communication, analytics, AI-assisted insights, and role-based digital workflows.
Designed, engineered, and developed by Divyam Madan
🌐 Live Demo: https://hostel-os.netlify.app
HostelOS is a next-generation intelligent hostel operating system designed to digitize, automate, secure, and optimize every major aspect of hostel life.
The project was built to address a common problem seen across many educational institutions: hostel management systems are often fragmented, outdated, disconnected, and highly dependent on manual processes.
Students struggle with visibility.
Wardens struggle with coordination.
Complaints disappear into spreadsheets.
Mess feedback goes unread.
Attendance systems are inefficient.
Events remain disconnected.
Communication is delayed.
And almost no meaningful analytics exist.
HostelOS was built as a unified digital ecosystem that brings together:
- Student services
- Hostel operations
- Administrative workflows
- Analytics
- Real-time communication
- AI-powered insights
- Attendance monitoring
- Event ecosystems
- Counselling systems
- Financial tracking
into a single platform.
The goal is not simply to create another dashboard.
The goal is to create a complete operating system for hostel life.
HostelOS reimagines hostels as intelligent digital ecosystems.
Instead of isolated modules and manual workflows, every major hostel operation becomes connected through a centralized real-time platform.
The platform attempts to provide:
- Better student experiences
- Faster administrative workflows
- Improved transparency
- Data-driven decision making
- Real-time operational awareness
- Intelligent hostel analytics
- Scalable infrastructure
for both students and hostel management teams.
Built using:
- React
- Vite
- React Router
- Context API
- Modular Component Architecture
- Responsive Layout Systems
- Dynamic Theme Infrastructure
- Real-Time Socket Synchronization
Features:
- Student Dashboard
- Warden Dashboard
- Dynamic Routing
- Protected Routes
- Lazy Loaded Pages
- Toast Notifications
- Theme Persistence
- Responsive Design
- Multi-Theme Support
Built using:
- Node.js
- Express.js
- REST APIs
- JWT Authentication
- SMTP Infrastructure
- Role-Based Middleware
- Socket.IO
- Centralized Error Handling
Features:
- Secure Authentication
- OTP Verification
- Role-Based Access Control
- Notification Services
- Analytics Engines
- AI Integrations
- Search Infrastructure
- Real-Time Broadcasting
Powered by:
- MongoDB Atlas
Database Architecture Includes:
- User Schemas
- Admin Schemas
- Complaint Models
- Event Models
- Team Models
- Laundry Models
- Leave Models
- Fee Models
- Wellbeing Models
- Lost & Found Models
- Notification Models
- Timetable Models
- Analytics Cache Models
HostelOS implements a multi-layer secure authentication architecture.
Students can:
- Register accounts
- Login securely
- Verify email addresses
- Recover passwords using OTP
- Update passwords
- Maintain secure sessions
- Access protected dashboards
Administrators use:
- Employee ID login
- Password authentication
- OTP verification
- Role-based dashboard access
- Administrative privileges
- Protected management routes
Implemented security measures include:
- JWT Authentication
- Password Hashing
- OTP Verification
- SMTP Email Validation
- Session Security
- Role-Based Middleware
- Protected APIs
- Request Validation
- Rate Limiting
- Authentication Guards
- Token Expiration Handling
One of the most advanced aspects of HostelOS is its real-time ecosystem.
Using Socket.IO, HostelOS behaves more like an operating system than a traditional CRUD application.
Real-time capabilities include:
- Live dashboard refreshes
- Instant complaint updates
- Real-time event participation counts
- Live attendance synchronization
- Notification broadcasting
- Administrative monitoring
- Dynamic analytics refreshes
- Student activity feeds
- Instant operational updates
HostelOS includes a comprehensive administrative intelligence system.
Administrators receive visibility into:
- Complaint trends
- Student activity
- Leave statistics
- Event participation
- Fee collections
- Attendance metrics
- Laundry utilization
- Wellbeing trends
- Mess feedback analytics
- Operational KPIs
Visualization systems include:
- Bar Charts
- Pie Charts
- Donut Charts
- Trend Graphs
- Activity Metrics
- Summary Cards
- Comparative Analytics
Students can raise complaints related to:
- WiFi
- Electricity
- Water Supply
- Furniture Damage
- Cleaning
- Noise Issues
- Pest Control
- Maintenance
- General Infrastructure
Administrative Features:
- Complaint Filtering
- Search
- Status Tracking
- Resolution Monitoring
- Category Analytics
- Priority Management
- Real-Time Updates
HostelOS contains a dedicated mess feedback ecosystem.
Students can submit meal-specific feedback for:
- Breakfast
- Lunch
- Snacks
- Dinner
AI processing enables:
- Sentiment Analysis
- Trend Detection
- Feedback Summarization
- Concern Identification
- Satisfaction Monitoring
- Positive Feedback Recognition
Integrated Gemini-based intelligence helps administrators identify operational improvements.
Students can:
- View academic schedules
- Access updated timetables
- Track class information
Administrators can:
- Create schedules
- Edit timetables
- Update entries
- Manage timetable records
HostelOS includes a complete event management infrastructure.
Students can:
- Register for events
- Join hackathons
- Create teams
- Track participation
- Monitor registrations
Administrators can:
- Create Events
- Delete Events
- Manage Registrations
- Track Participation
- View Analytics
Supported Features:
- Team Registration
- Seat Tracking
- Registration Monitoring
- Live Event Updates
Hackathon and event workflows include:
- Team Creation
- Team Joining
- Team Management
- Member Tracking
- Participation Analytics
The platform includes a complete laundry booking infrastructure.
Features:
- Slot Booking
- Live Availability Tracking
- Booking Confirmation
- Occupancy Monitoring
- Schedule Visibility
- Usage Analytics
Students can:
- Report Lost Items
- Report Found Items
- Upload Images
- Add Descriptions
- Add Locations
- Contact Owners
- Claim Items
Administrative Features:
- Item Monitoring
- Claim Tracking
- Analytics Integration
- Category Management
Students can:
- Submit Leave Requests
- Request Outings
- Track Approval Status
- View Request History
Administrators can:
- Approve Requests
- Reject Requests
- Monitor Trends
- Analyze Student Movement Patterns
A privacy-focused wellbeing ecosystem.
Students can:
- Book Counselling Sessions
- Submit Wellbeing Logs
- Schedule Support Visits
- Track Stress Levels
- Request Assistance
Administrators can:
- Monitor Trends
- View Aggregated Analytics
- Manage Sessions
- Track Support Demand
HostelOS includes healthcare support workflows.
Features include:
- Emergency Reporting
- Medical Assistance Requests
- Health Monitoring Interfaces
- Student Care Workflows
Students can:
- Track Fee Status
- View Payment History
- Monitor Dues
Administrators can:
- Track Collections
- Monitor Pending Fees
- Analyze Revenue Metrics
- Generate Financial Insights
HostelOS includes a centralized notification ecosystem.
Supports:
- Real-Time Notifications
- Dashboard Alerts
- Event Announcements
- Complaint Updates
- Administrative Broadcasts
- System Messages
Role-aware intelligent search functionality enables users to search across:
- Students
- Events
- Timetables
- Complaints
- Laundry
- Leaves
- Fees
- Lost & Found
- Wellbeing Records
Search results are dynamically routed based on role permissions.
HostelOS focuses heavily on experience design.
Features include:
- Glassmorphism Effects
- Dynamic Themes
- Sunset Dark Theme
- Morning Cream Theme
- Rose Quartz Theme
- Theme Persistence
- Responsive Layouts
- Accessibility-Oriented Contrast
- Real-Time UI Refreshes
- Animated Interactions
Major engineering challenges included:
- Socket Synchronization
- Real-Time State Management
- Authentication Architecture
- OTP Infrastructure
- MongoDB Data Modeling
- Route Protection
- Role Separation
- Dashboard Synchronization
- Search Index Logic
- Image Upload Handling
- Notification Architecture
- Analytics Aggregation
- Live Updates
- Session Expiration Handling
- Middleware Security
- Deployment Configuration
Frontend:
- React
- Vite
- JavaScript
- CSS
- Socket.IO Client
- Recharts
Backend:
- Node.js
- Express.js
- Socket.IO
- JWT
- Nodemailer
Database:
- MongoDB Atlas
AI:
- Google Gemini API
Infrastructure:
- Netlify
- Railway / Render
- GitHub
HostelOS is not merely a hostel dashboard.
It represents an attempt to redesign hostel infrastructure using modern software engineering principles.
The platform combines:
- Full-Stack Development
- Systems Thinking
- Real-Time Computing
- Analytics Engineering
- AI Integration
- Human-Centered Design
- Security Engineering
- Scalable Architecture
into one cohesive ecosystem.
HostelOS began as a simple concept and evolved into a large-scale engineering project involving months of feature development, architecture redesign, debugging, analytics implementation, real-time infrastructure integration, security hardening, and user experience refinement.
Every major system, architecture decision, feature expansion, redesign iteration, integration workflow, and deployment pipeline present in the current version of HostelOS was engineered and developed by Divyam Madan.
GitHub: https://github.com/Divyam-Madan
LinkedIn: divyam-madan
Email: divyam.madan.6106@gmail.com