{"id":29130476,"url":"https://github.com/nobokumar/travoa-hotel-booking-platform-client","last_synced_at":"2026-05-03T22:31:13.657Z","repository":{"id":301811402,"uuid":"1010382162","full_name":"noboKumar/TraVoa-hotel-Booking-Platform-Client","owner":"noboKumar","description":"A modern MERN stack hotel booking platform with secure authentication, dynamic room discovery, booking management, and user reviews.","archived":false,"fork":false,"pushed_at":"2025-06-29T00:24:38.000Z","size":1686,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-29T01:34:48.517Z","etag":null,"topics":["daisyui","fireabase-auth","hotel-booking","react","reactrouter","tailwindcss"],"latest_commit_sha":null,"homepage":"https://ph-assignment-11-travoa.netlify.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/noboKumar.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,"zenodo":null}},"created_at":"2025-06-29T00:22:55.000Z","updated_at":"2025-06-29T00:27:10.000Z","dependencies_parsed_at":"2025-06-29T01:35:05.963Z","dependency_job_id":"3d0b625a-d405-4571-bdc8-f1e114223cf1","html_url":"https://github.com/noboKumar/TraVoa-hotel-Booking-Platform-Client","commit_stats":null,"previous_names":["nobokumar/travoa-hotel-booking-platform-client-0"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/noboKumar/TraVoa-hotel-Booking-Platform-Client","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noboKumar%2FTraVoa-hotel-Booking-Platform-Client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noboKumar%2FTraVoa-hotel-Booking-Platform-Client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noboKumar%2FTraVoa-hotel-Booking-Platform-Client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noboKumar%2FTraVoa-hotel-Booking-Platform-Client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/noboKumar","download_url":"https://codeload.github.com/noboKumar/TraVoa-hotel-Booking-Platform-Client/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noboKumar%2FTraVoa-hotel-Booking-Platform-Client/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262708005,"owners_count":23351532,"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","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":["daisyui","fireabase-auth","hotel-booking","react","reactrouter","tailwindcss"],"created_at":"2025-06-30T04:05:49.486Z","updated_at":"2025-10-16T10:10:38.650Z","avatar_url":"https://github.com/noboKumar.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🏨 TraVoa – Hotel Booking Platform\n\n🔗 **Live Site URL**: [https://travoa.netlify.app/](https://travoa.netlify.app/)\n\n---\n\n## 📌 Project Description\n\n**TraVoa** is a modern, full-featured **Hotel Booking Platform** built using the MERN stack with secure authentication and dynamic features. It offers users a seamless experience for discovering and booking hotel rooms, submitting reviews, and managing their bookings. The platform is mobile-responsive, secure, and designed to be both functional and visually appealing for users and recruiters.\n\n---\n\n## ✨ Features\n\n- 🏡 **Homepage**\n\n  - Hero Banner with SwiperJS Slider\n  - Integrated Hotel Map using `react-leaflet`\n  - Featured Rooms with rating, image, price, and quick booking\n  - Testimonial carousel with sorted real user reviews\n  - Special Offers and Promotions modal\n\n- 🔐 **Authentication**\n\n  - Email \u0026 Password Authentication with Validation\n  - Google Sign-In support\n  - Secure private routes using JWT\n  - SweetAlert2 \u0026 Toast notifications\n\n- 🛏️ **Rooms Page**\n\n  - Browse all hotel rooms with filter by price range\n  - Dynamic routing to Room Details\n\n- 📄 **Room Details**\n\n  - Full room info from database\n  - Review section with user-submitted reviews and timestamps\n  - Book Now modal with date picker and real-time availability check\n\n- 📆 **Bookings System**\n\n  - View and manage bookings in \"My Bookings\" page\n  - Cancel booking with date restriction logic\n  - Update booking date with live feedback\n  - Add reviews only after successful booking\n\n- 📉 **Review System**\n\n  - Review modal with rating (1–5), timestamp, and display on room details\n  - Sorted descending by latest\n\n- ❌ **404 Page**\n  - Custom 404 with Lottie react and redirect button\n\n---\n\n## 🔒 Security\n\n- Firebase config and MongoDB credentials are securely handled via environment variables.\n- JWT tokens stored on client side and verified on private routes.\n- CORS handled for deployment with proper domain whitelist.\n\n---\n\n## 🛠️ Tech Stack\n\n- **Frontend**: React, Tailwind CSS, DaisyUI\n- **Backend**: Node.js, Express.js\n- **Database**: MongoDB Atlas\n- **Authentication**: Firebase + JWT\n- **Routing**: React Router\n\n---\n\n## 📦 NPM Packages Used\n\n**Client Side:**\n\n- `tailwindcss` – Utility-first CSS framework\n- `daisyui` – Tailwind UI components\n- `axios` – API calls\n- `firebase` – Auth \u0026 Firestore integration\n- `lottie-react` – 404 \u0026 promo animations\n- `sweetalert2` – Alerts \u0026 notifications\n- `@smastrom/react-rating` – Star rating input\n- `react-leaflet` – Map \u0026 marker rendering\n- `swiper` – Hero banner slider\n- `moment` – Date manipulation\n- `framer-motion` – Component animations\n- `react-countup` – Dynamic number animations\n- `react-day-picker` – Date picker in booking\n- `react-helmet` – Dynamic tab title \u0026 meta\n- `react-icons` – Iconography\n- `react-router-dom` – Routing\n\n**Server Side:**\n\n- `express` – Web framework\n- `cors` – CORS configuration\n- `dotenv` – Environment variable management\n- `firebase-admin` – Admin SDK for secure access\n- `mongodb` – Database client\n\n---\n\n## 📱 Responsiveness\n\nTraVoa is fully optimized for all screen sizes:  \n✅ Mobile  \n✅ Tablet  \n✅ Desktop\n\n---\n### 🚀 Run the Project Locally:\n\n1. **Clone the Repository**\n\n```bash\ngit clone https://github.com/noboKumar/TraVoa-Hotel-Booking-Platform-Client.git\ncd TraVoa-Hotel-Booking-Platform-Client\n```\n\n2. **Install Dependencies**\n\n```bash\nnpm install\n```\n\n3. **Set Environment Variables**\n\nCreate a `.env` file in the root directory:\n\n```env\nVITE_FIREBASE_API_KEY=your_api_key\nVITE_FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com\nVITE_FIREBASE_PROJECT_ID=your_project_id\nVITE_FIREBASE_STORAGE_BUCKET=your_project.appspot.com\nVITE_FIREBASE_MESSAGING_SENDER_ID=your_sender_id\nVITE_FIREBASE_APP_ID=your_app_id\n\nVITE_SERVER_URL=http://localhost:5000\n```\n\n4. **Start the Development Server**\n\n```bash\nnpm run dev\n```\n\n\u003e App will run at **[http://localhost:5173](http://localhost:5173)**\n\n---\n\n### 🔧 Backend Setup (Node.js + Express)\n\n1. **Navigate to Backend Folder** (if it's a separate folder like `/server`):\n\n```bash\ncd server\n```\n\n2. **Install Backend Dependencies**\n\n```bash\nnpm install\n```\n\n3. **Create a `.env` file**\n\n```env\nPORT=3000\nDB_URI=your_mongodb_connection_string\n```\n\n4. **Start the Backend Server**\n\n```bash\nnpm run dev\n```\n\n\u003e Server will run at **[http://localhost:3000](http://localhost:3000)**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnobokumar%2Ftravoa-hotel-booking-platform-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnobokumar%2Ftravoa-hotel-booking-platform-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnobokumar%2Ftravoa-hotel-booking-platform-client/lists"}