NexStay is a modern, responsive web application designed for educational institutions to streamline hostel operations. It centralizes student resident services, warden supervision, and administrative management into a unified platform.
- About The Project
- Key Portals
- Core Features
- Technology Stack
- Project Directory Structure
- Getting Started
- Prerequisites
- Installation
- Running Locally
- Usage Guide
- Configuration
- License
Traditional hostel management relies on paper registers, manual gate pass verification, and disjointed communication channels. NexStay provides a digital alternative that manages room allocations, attendance, digital out-passes, mess billing, maintenance requests, and administrative analytics in real time.
Developed for Invertis University, Bareilly, Uttar Pradesh, India, as a comprehensive campus management solution.
- Interactive showcase of hostel facilities, pricing plans, and room tiers.
- Live room allotment inquiry and contact forms.
- Frequently Asked Questions (FAQ) with category filtering.
- Direct quick-access authentication modals for students, wardens, and administrators.
- Room allocation and roommate details.
- Digital Gate Pass / Leave Application submission with real-time approval status.
- Complaint and maintenance ticketing system with category tracking.
- Weekly mess meal menu and meal attendance tracking.
- Fee payment history, invoices, and payment receipts.
- Personal profile and emergency contact management.
- Block-wise student directory and occupancy monitoring.
- Gate Pass review queue with instant Approve / Reject controls.
- Incident and discipline log management.
- Real-time room inspection and roll-call checklist.
- Broadcast notice publishing for hostellers.
- Campus-wide analytics dashboard (Total Capacity, Occupancy Rate, Revenue, Active Passes).
- Interactive occupancy and fee collection charts powered by Chart.js.
- Hostel Block, Room, and Inventory management.
- Staff access assignment and role management.
- Data export capabilities (CSV report downloads).
- Multi-Role Access: Tailored interfaces for Students, Wardens, and Admins.
- Gate Pass Workflow: Digital application and authorization system with QR/reference verification.
- Maintenance Desk: Status tracking (Pending, In Progress, Resolved) for electrical, plumbing, and carpentry complaints.
- Responsive Design: Optimized layout supporting mobile phones, tablets, and desktop workstations.
- Theme Support: Built-in Light and Dark mode options stored in browser local storage.
- Local Storage Persistence: Client-side storage ensures custom entries, passes, and preferences persist across sessions without external database setup.
- SEO and Performance Optimized: Asynchronous resource loading, preconnected font origins, and mobile viewport compliance.
- Frontend: HTML5, CSS3 (Custom Variables, Flexbox, Grid), JavaScript (Vanilla ES6+)
- Styling & Icons: Modern typography with Google Fonts (Outfit), Font Awesome Icon Library
- Data Visualization: Chart.js (Admin analytics and occupancy trends)
- Backend / Server: Node.js, Express.js
- Package Management: npm / bun
nexstay-hostel-management/
├── admin.html # Administrator Control Center
├── dashboard.html # Student Resident Dashboard
├── index.html # Landing Page & Portal Gateway
├── warden.html # Warden Management Portal
├── hostel_inventory.csv # Sample hostel inventory dataset
├── metadata.json # Application metadata and attributes
├── package.json # Node.js project configuration and scripts
├── server.js # Express static file server
├── css/
│ └── style.css # Global stylesheet, design tokens, responsive rules
└── js/
└── script.js # Core application logic, role management, state handlers
Ensure you have Node.js (version 18.x or higher) installed on your system.
To check your Node.js version:
node -v
npm -v-
Clone or download the repository to your local machine:
git clone https://github.com/your-username/nexstay.git cd nexstay -
Install the required Node dependencies:
npm install
Start the local development server:
npm run devor
npm startOpen your browser and navigate to:
http://localhost:3000
- Landing Page: Navigate through the features, explore available room tiers, or select your role from the top navigation.
- Student Login: Click on "Student Portal" or use the top navigation button to access room details, request leave passes, or file complaints.
- Warden Access: Use "Warden Portal" to manage student entries, verify leave applications, and view block rosters.
- Admin Access: Use "Admin Portal" to view financial summaries, block allotments, and occupancy statistics.
- Dark Mode: Toggle the theme button in the navigation bar to switch between Light and Dark display modes.
- Port Configuration: Set the
PORTenvironment variable in your.envfile or export it before runningnode server.js. Default is3000. - Data Persistence: By default, client state is managed via
localStorage. For production database integration, connect backend endpoints inserver.js.
This project is licensed under the MIT License - feel free to use and adapt it for academic and institutional purposes.