
Tech Stack
Next.js 15 (App Router) •TypeScript •Firebase •Tailwind CSS •Resend •Recharts •
The Gist
Adotey Hostels is a modern room booking Progressive Web App (PWA) tailored for student accommodation. The project seamlessly integrates a frictionless public booking system with a robust administrative dashboard, all driven by a real-time Firebase backend and Next.js.
The Challenge
The hostel needed to transition from manual, offline tracking to a streamlined digital platform to manage room allocations, track occupancy, and process student bookings efficiently.
The core challenges were:
- Reducing friction for students: Allowing users to easily browse room types (e.g., 2-person, 4-person), check live availability, and request bookings without the hurdle of creating an account.
- Administrative control: Empowering hostel management to oversee active semesters, update room amenities, and handle booking approvals from a centralized, secure dashboard.
- Automated communication: Eliminating manual follow-ups by ensuring students receive immediate, branded email confirmations upon booking.
- Data visibility: Providing management with actionable insights and visual analytics regarding occupancy rates and booking statuses.
- Mobile accessibility: Delivering an app-like experience that works perfectly on both desktop and mobile devices without requiring submission to app stores.
The Solution
A comprehensive, responsive web application divided into a frictionless public browsing experience and a protected, role-based admin dashboard, designed with a premium gold and white theme.
Customer (Student) Features:
- Public room browsing with real-time occupancy indicators and capacity filtering.
- Intuitive, no-login booking form that allows students to secure specific room types and bed numbers.
- Self-service booking status lookup allowing students to track their application via email.
- Full PWA support, enabling students to install the app directly to their mobile home screens for native-like access.
Admin Features:
- Secure admin dashboard protected by role-based access control (Firebase Authentication).
- Room manager — dynamically add, edit, or delete rooms, configure pricing, manage amenities, and track current occupancy.
- Booking and Semester manager — review incoming student requests, approve or cancel bookings, and define start/end dates for active academic terms.
- Analytics and reporting dashboard leveraging dynamic visual charts to track structural occupancy and revenue stats.
- Automated email pipeline to broadcast status updates and send personalized receipts to applicants.
Technical highlights:
- Built utilizing the Next.js 15 App Router for optimal server-side rendering performance and clean API route architecture.
- Real-time data synchronization via Firebase Firestore, ensuring that room capacities instantly update when a booking is confirmed to prevent double-booking.
- PDF generation and data export tooling integrated directly into the application for administrative record-keeping.
- Built utilizing accessible, highly customizable UI primitive components via shadcn/ui and Tailwind CSS.



Ready for more?
Next Project