🏨 Room Status Dashboard

A real-time room availability dashboard for guest houses. Built by Nilachal Tech Solutions.

Features

• Real-time sync — Status updates appear instantly across all devices
• Two views — Front Desk (staff) and Owner (admin)
• Mobile-first — Works on any phone browser, no app download needed
• Simple PIN login — Staff uses 4-digit PIN, Owner uses email/password
• History log — Track all status changes with timestamps
• Add/remove rooms — Owner can manage rooms from the dashboard

Tech Stack

Layer	Technology
Frontend	React (Vite)
Database	Firebase Firestore
Auth	Firebase Auth
Hosting	Firebase Hosting
Styling	Tailwind CSS

Quick Start

1. Clone the repository

git clone <repository-url>
cd room-status-dashboard

2. Install dependencies

npm install

3. Set up Firebase

1. Go to Firebase Console
2. Create a new project
3. Enable Firestore, Auth, and Hosting
4. Copy your Firebase config to .env:

cp .env.example .env
# Edit .env with your Firebase credentials

4. Run development server

npm run dev

5. Deploy to Firebase Hosting

npm run build
firebase deploy

Project Structure

src/
├── components/
│   ├── RoomCard.jsx          # Individual room tile
│   ├── RoomGrid.jsx          # Grid of room cards
│   ├── StatusModal.jsx       # Bottom sheet for status updates
│   ├── SummaryBar.jsx        # Stats bar (Total/Available/Occupied...)
│   ├── FilterTabs.jsx        # Filter by status
│   ├── HistoryLog.jsx        # Status change history
│   └── LoginScreen.jsx       # PIN/Email login
├── pages/
│   ├── FrontDeskPage.jsx     # Staff view
│   └── OwnerDashboard.jsx    # Owner view
├── firebase/
│   ├── config.js             # Firebase initialization
│   ├── roomService.js        # Firestore operations
│   └── authService.js        # Authentication logic
├── hooks/
│   └── useRooms.js           # Real-time rooms hook
└── utils/
    └── constants.js          # Status colors and labels

User Roles

Front Desk Staff

• Login with 4-digit PIN
• Update room status (Available/Occupied/Cleaning/Maintenance)
• View room grid with color-coded status

Owner/Admin

• Login with email + password
• View all rooms and stats
• Add/remove rooms
• View status change history
• Reset staff PIN

Room Statuses

Status	Color	Description
Available	🟢 Green	Room is empty and ready
Occupied	🔴 Red	Guest is checked in
Cleaning	🟡 Yellow	Room being cleaned
Maintenance	⚪ Grey	Room under repair

Firebase Setup

Firestore Collections

• rooms/ — Room data (number, type, status, guest name)
• statusHistory/ — Log of all status changes
• settings/ — Guest house config, staff PIN

Security Rules

Staff can only update room status. Owner has full access.

Cost

For a 10-30 room guest house: ₹0 to ₹500/month on Firebase free tier.

License

Built by Nilachal Tech Solutions © 2025

RoomOperationDashboard