{"id":25121291,"url":"https://github.com/sumiyarahman/hotel-booking-client","last_synced_at":"2026-04-11T05:03:29.409Z","repository":{"id":275943857,"uuid":"927683478","full_name":"SumiyaRahman/hotel-booking-client","owner":"SumiyaRahman","description":"The Hotel Booking Platform is a modern web application that provides users with a seamless experience for discovering and booking hotel rooms. It combines interactive design, secure authentication, and efficient booking management to enhance user experience.","archived":false,"fork":false,"pushed_at":"2025-02-12T13:20:07.000Z","size":13957,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-02T15:23:46.429Z","etag":null,"topics":["css3","expressjs","firebase","framer-motion","html5","jwt","mongodb","nodejs","react","tailwindcss"],"latest_commit_sha":null,"homepage":"https://hotel-room-booking-8fc54.web.app/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SumiyaRahman.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-05T11:18:04.000Z","updated_at":"2025-02-12T13:20:10.000Z","dependencies_parsed_at":"2025-02-05T12:48:17.554Z","dependency_job_id":null,"html_url":"https://github.com/SumiyaRahman/hotel-booking-client","commit_stats":null,"previous_names":["sumiyarahman/hotel-booking-client"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/SumiyaRahman/hotel-booking-client","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SumiyaRahman%2Fhotel-booking-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SumiyaRahman%2Fhotel-booking-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SumiyaRahman%2Fhotel-booking-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SumiyaRahman%2Fhotel-booking-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SumiyaRahman","download_url":"https://codeload.github.com/SumiyaRahman/hotel-booking-client/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SumiyaRahman%2Fhotel-booking-client/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270579613,"owners_count":24610044,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-15T02:00:12.559Z","response_time":110,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["css3","expressjs","firebase","framer-motion","html5","jwt","mongodb","nodejs","react","tailwindcss"],"created_at":"2025-02-08T06:17:42.288Z","updated_at":"2025-12-30T18:53:15.142Z","avatar_url":"https://github.com/SumiyaRahman.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🏨 Hotel Booking Platform\n\n![Hotel Booking Banner](https://i.ibb.co/whQL2XNb/Screenshot-218.png)\n\n## 🚀 Project Overview\nThe **Hotel Booking Platform** is a modern web application that provides users with a seamless experience for discovering and booking hotel rooms. It combines interactive design, secure authentication, and efficient booking management to enhance user experience.\n\n---\n\n## 🌐 Live Demo\n🔗 [Hotel Booking Platform - Live](#) *(https://hotel-room-booking-8fc54.web.app/)*\n\n---\n\n## ✨ Key Features\n\n### 🏡 Homepage Design\n- **Dynamic Banner**: A slider section with a title, description, and a call-to-action button.\n- **Interactive Map**: Displays hotel locations using `react-leaflet`.\n- **Featured Rooms**: Highlights six top-rated rooms with images, descriptions, and booking options.\n- **User Reviews**: Authentic testimonials displayed in a sorted format.\n- **Special Offers**: Engaging modal pop-ups showcasing promotions.\n\n### 🔑 User Authentication\n- Secure **email/password-based login**.\n- Social login (Google/GitHub).\n- Password validation ensuring security.\n- Toast notifications for authentication actions.\n\n### 🧭 Navigation Bar\n- Links to \"Rooms\" and \"My Bookings\".\n- Conditional rendering for authenticated users.\n\n### 🛌 Rooms Page\n- Displays all available rooms with detailed information.\n- Clicking a room opens its **details page**.\n- Users can filter rooms based on **price range**.\n\n### 🏡 Room Details Page\n- Shows room description, price, and user reviews.\n- **Booking System**: Allows users to book rooms with a date selector.\n- **Availability Check**: Ensures rooms are not double-booked.\n\n### 📋 My Bookings Page\n- Displays rooms booked by the user.\n- **Cancel Booking**: Users can cancel bookings before the due date.\n- **Modify Booking Date**: Users can update their booking date.\n- **Review System**: Users can rate and review booked rooms.\n\n### 🔐 Access Control\n- Guests can only view room details but cannot book rooms.\n- **Private Routes** for authenticated users.\n\n### 🚀 Additional Features\n- **404 Page**: Custom error page with a fun GIF and redirect option.\n- **JWT Authentication**: Secure user sessions using JSON Web Tokens.\n- **Sorting \u0026 Filtering**: Reviews sorted in descending order based on timestamps.\n\n---\n\n## 🛠️ Technologies \u0026 Packages Used\n- **Frontend**: React, Tailwind CSS, DaisyUI, Framer Motion\n- **Authentication**: Firebase (email/password, Google, GitHub)\n- **Database**: MongoDB\n- **Backend**: Node.js, Express.js\n- **State Management**: React Query (TanStack Query)\n- **Map Library**: `react-leaflet`\n- **Helmet**: SEO and metadata management\n- **Moment.js**: Date manipulation\n- **JWT**: Authentication \u0026 authorization\n\n---\n\n## 📂 Folder Structure\n```\n📂 hotel-booking-platform\n├── 📂 client  (Frontend)\n│   ├── src\n│   │   ├── components\n│   │   ├── pages\n│   │   ├── hooks\n│   │   ├── utils\n├── 📂 server  (Backend)\n│   ├── routes\n│   ├── models\n│   ├── controllers\n│   ├── middleware\n│   ├── config\n```\n\n---\n\n## 📝 Setup Instructions\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/SumiyaRahman/hotel-booking-client.git\n   ```\n2. Install dependencies:\n   ```bash\n   cd client \u0026\u0026 npm install\n   cd ../server \u0026\u0026 npm install\n   ```\n3. Create `.env` files for Firebase \u0026 MongoDB configuration.\n4. Run the development server:\n   ```bash\n   npm run dev\n   ```\n5. Access the website at `https://hotel-room-booking-8fc54.web.app/`\n\n---\n\n## 📌 Contribution Guidelines\n- Create meaningful commits with descriptive messages.\n- Ensure responsive design on mobile, tablet, and desktop.\n- Maintain code readability and proper alignment.\n\n\n🚀 Happy Coding!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsumiyarahman%2Fhotel-booking-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsumiyarahman%2Fhotel-booking-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsumiyarahman%2Fhotel-booking-client/lists"}