{"id":25091465,"url":"https://github.com/farhanasharna2000/suitespot-client","last_synced_at":"2026-04-10T07:52:10.475Z","repository":{"id":271457634,"uuid":"909945525","full_name":"Farhanasharna2000/SuiteSpot-Client","owner":"Farhanasharna2000","description":"SuiteSpot is a feature-rich and user-friendly hotel booking platform designed to simplify travel planning and enhance the user experience. Built using modern web technologies, SuiteSpot combines performance, scalability, and a beautiful interface to deliver a seamless hotel search and booking experience.","archived":false,"fork":false,"pushed_at":"2025-02-05T08:51:15.000Z","size":21257,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-05T09:32:56.018Z","etag":null,"topics":["firebase","mongodb-atlas","nodejs","react","react-router","tailwindcss"],"latest_commit_sha":null,"homepage":"https://suitespot-719f8.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/Farhanasharna2000.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":"2024-12-30T05:56:08.000Z","updated_at":"2025-02-05T08:52:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"151b49e0-0f85-4303-83ea-67e39c91b137","html_url":"https://github.com/Farhanasharna2000/SuiteSpot-Client","commit_stats":null,"previous_names":["farhanasharna2000/suitespot-client"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Farhanasharna2000%2FSuiteSpot-Client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Farhanasharna2000%2FSuiteSpot-Client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Farhanasharna2000%2FSuiteSpot-Client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Farhanasharna2000%2FSuiteSpot-Client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Farhanasharna2000","download_url":"https://codeload.github.com/Farhanasharna2000/SuiteSpot-Client/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246709924,"owners_count":20821298,"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":["firebase","mongodb-atlas","nodejs","react","react-router","tailwindcss"],"created_at":"2025-02-07T13:35:00.092Z","updated_at":"2026-04-10T07:52:05.430Z","avatar_url":"https://github.com/Farhanasharna2000.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🏨 **SuiteSpot**: Modern Hotel Booking Platform  \n\n![SuiteSpot Banner](/public/suitespot.png)  \n\nSuiteSpot is a feature-rich and user-friendly hotel booking platform designed to simplify travel planning and enhance the user experience. Built using modern web technologies, SuiteSpot combines performance, scalability, and a beautiful interface to deliver a seamless hotel search and booking experience.\n\n---\n\n## 🎯 **Project Purpose**  \n\nThe purpose of SuiteSpot is to provide users with a convenient platform to:  \n- Search and compare hotels using interactive maps and filters.  \n- Book accommodations with real-time availability.  \n- Enjoy a visually appealing and responsive interface on all devices.  \n\n---\n\n## 🌍 **Live URL**  \n\nExperience **SuiteSpot** live:  \n➡️ **[Visit SuiteSpot](https://suitespot-719f8.web.app)**  \n\n---\n\n## ✨ **Key Features**  \n\n### 🎨 **Interactive and Engaging UI**  \n- **Animations on Scroll (AOS)**: Smooth and elegant scroll-based animations.  \n- **Framer Motion**: Modern animations for interactive elements.  \n- **Lottie Animations**: High-quality animations powered by **lottie-react**.  \n\n### 🗺 **Comprehensive Hotel Search**  \n- **Leaflet \u0026 React-Leaflet**: Interactive maps for browsing hotels by location.  \n- **Match Sorter**: Advanced filtering and ranking for search results.  \n\n### 📅 **Booking and Availability Management**  \n- **Moment.js**: Easy handling of dates for availability and bookings.  \n- **React Datepicker**: Simplified date selection for check-in and check-out.  \n\n### 🚀 **Modern Web Features**  \n- **React Router DOM**: Seamless page transitions with route management.  \n- **Axios**: Efficient API communication for fetching hotel data.  \n- **Firebase**: Secure authentication and database storage.  \n- **LocalForage**: Client-side caching for improved performance.  \n\n### 🔥 **Enhanced User Experience**  \n- **React Hot Toast**: Toast notifications for user feedback.  \n- **SweetAlert2**: Elegant modals for alerts and confirmations.  \n- **React Star Rating Component**: Easy hotel rating visualization.  \n- **Swiper**: Sleek carousel implementation for image galleries.  \n\n### 🌍 **SEO and Performance Optimization**  \n- **React Helmet**: Dynamic meta tags for better SEO.  \n- **Sort By**: Utility for sorting hotel data efficiently.  \n\n---\n\n## 🛠 **Tech Stack**  \n\n- **Frontend:** React, React Router, Tailwind CSS \n- **State Management:** React Query  \n- **Backend:** [SuiteSpot API](https://suite-spot-server-psi.vercel.app) (Node.js, Express)  \n- **Authentication:** Firebase  \n- **Database:** MongoDB \n- **Deployment:** Vercel (Backend), Firebase (Frontend)  \n\n---\n\n## 📦 **Installation**  \n\nTo set up the project locally, follow these steps:\n\n### 1️⃣ Clone the repository  \n```sh\ngit clone https://github.com/Farhanasharna2000/SuiteSpot-Client\ncd SuiteSpot-Client  \n```\n\n### 2️⃣ Install dependencies  \n```sh\nnpm install  \n```\n\n### 3️⃣ Create a `.env` file  \nSet up environment variables in a `.env` file at the root directory:  \n\n```ini\nVITE_apiKey=your_firebase_api_key  \nVITE_authDomain=your_firebase_auth_domain  \nVITE_projectId=your_firebase_project_id  \nVITE_storageBucket=your_firebase_storage_bucket  \nVITE_messagingSenderId=your_firebase_messaging_sender_id  \nVITE_appId=your_firebase_app_id  \nVITE_API_URL=https://suite-spot-server-psi.vercel.app  \n```\n\n**⚠️ Never expose your API keys in public repositories.**  \n\n### 4️⃣ Start the development server  \n```sh\nnpm run dev  \n```\n\n---\n\n## ⚙️ **Configuration**  \n\nSuiteSpot uses Firebase for authentication and Firestore for the database. Ensure you have a Firebase project set up and configured correctly.\n\n- **Backend API**: The API is hosted on Vercel at [`https://suite-spot-server-psi.vercel.app`](https://suite-spot-server-psi.vercel.app).  \n\n---\n\n## 🚀 **Usage**  \n\nOnce the project is running:  \n- Sign up or log in.  \n- Browse and discover hotels.  \n- Filter hotels based on location and amenities.  \n- Select dates and book available hotels.  \n- Leave reviews and rate hotels.  \n\n---\n\n## 🤝 **Contributing**  \n\nWe welcome contributions! To contribute:  \n1. Fork the repository.  \n2. Create a new branch (`feature-xyz`).  \n3. Commit your changes.  \n4. Push to your branch.  \n5. Open a Pull Request.  \n\n---\n\n🎉 **Enjoy using SuiteSpot!** 🚀  \n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffarhanasharna2000%2Fsuitespot-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffarhanasharna2000%2Fsuitespot-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffarhanasharna2000%2Fsuitespot-client/lists"}