{"id":26269744,"url":"https://github.com/shahadathhs/room-ready-client","last_synced_at":"2026-04-12T19:47:15.848Z","repository":{"id":261897799,"uuid":"811445802","full_name":"shahadathhs/room-ready-client","owner":"shahadathhs","description":"This is client side code repository of \"RoomReady\" website.","archived":false,"fork":false,"pushed_at":"2024-11-09T04:22:46.000Z","size":1894,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-09T05:22:28.718Z","etag":null,"topics":["aos-animation","css","farmer-motion","firebase-auth","html","javascript","reactjs","rest-api","tailwindcss"],"latest_commit_sha":null,"homepage":"https://eleventh-a-roomready.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/shahadathhs.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-06-06T15:59:25.000Z","updated_at":"2024-11-09T04:22:50.000Z","dependencies_parsed_at":"2024-11-09T05:32:45.678Z","dependency_job_id":null,"html_url":"https://github.com/shahadathhs/room-ready-client","commit_stats":null,"previous_names":["shahadathhs/room-ready-client"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shahadathhs%2Froom-ready-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shahadathhs%2Froom-ready-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shahadathhs%2Froom-ready-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shahadathhs%2Froom-ready-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shahadathhs","download_url":"https://codeload.github.com/shahadathhs/room-ready-client/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243526934,"owners_count":20305115,"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":["aos-animation","css","farmer-motion","firebase-auth","html","javascript","reactjs","rest-api","tailwindcss"],"created_at":"2025-03-14T05:15:55.123Z","updated_at":"2025-12-27T23:28:26.706Z","avatar_url":"https://github.com/shahadathhs.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RoomReady | Seamless Hotel Booking Experience\n\n- Live Site URL: [RoomReady](https://eleventh-a-roomready.web.app)\n\n\n- Tools \u0026 Technology\n  - HTML\n  - CSS\n  - Tailwind CSS\n  - JavaScript\n  - React.js\n  - React Router\n  - Firebase Authentication\n  - Firebase Hosting\n  - Vercel (Server Deployment)\n\n## How to run locally\n\n### Prerequisites\n\n- Node.js (v14 or higher)\n- MongoDB (local or Atlas)\n- Firebase account for authentication and hosting\n\n### Running the Frontend Locally\n\n1. **Clone the repository**\n\n   ```bash\n   git clone https://github.com/shahadathhs/room-ready-client.git\n   ```\n\n2. **Navigate to the project directory**\n\n   ```bash\n   cd room-ready-client\n   ```\n\n3. **Install dependencies**\n\n   ```bash\n   npm install\n   ```\n\n4. **Create a `.env.local` file in the root directory and add the following environment variables with your own credentials:**\n\n   ```env\n   VITE_APIKEY=your_firebase_api_key\n   VITE_AUTHDOMAIN=your_firebase_auth_domain\n   VITE_PID=your_firebase_project_id\n   VITE_STORAGE=your_firebase_storage_bucket\n   VITE_MESSAGE=your_firebase_messaging_sender_id\n   VITE_APPTD=your_firebase_app_id\n\n   VITE_API_URL=your_server_api_url\n\n   VITE_IMAGE_HOSTING_KEY=your_imgbb_api_key\n\n   VITE_PAYMENT_GATEWAY_PK=your_stripe_public_key\n   ```\n\n5. **Start the development server**\n\n   ```bash\n   npm run dev\n   ```\n\n### Running the Backend Locally\n\n- **Visit server repository:** [Server Repository on GitHub](https://github.com/shahadathhs/room-ready-server)\n\n\n\n## Features\n\n- **Visual Experience Banner:** Engage users with captivating images of luxurious hotel rooms, enticing them to explore further.\n\n- **Interactive Map:** Provide users with an easy-to-access map displaying the hotel's location, enhancing convenience for potential guests.\n\n- **Newsletter Sign-Up:** Encourage users to subscribe to newsletters for updates, exclusive offers, and deals, enhancing customer engagement and retention.\n\n- **Featured Rooms:** Highlight a curated selection of rooms with attractive images and descriptions, facilitating quick bookings with a prominent \"Book Now\" button.\n\n- **User Reviews:** Showcase authentic user reviews and ratings prominently on the homepage using a testimonial carousel, building trust and credibility for prospective guests.\n\n- **User Authentication:** Enable seamless user authentication with options for email/password-based login and Google authentication via Firebase, ensuring secure access to personalized features.\n\n- **Navigation Bar:** Streamline navigation with links to essential pages like \"Rooms\" and \"My Bookings,\" ensuring easy access to key functionalities for users.\n\n- **Rooms Page:** Present a comprehensive list of available rooms with filtering options by price range, enabling users to find their ideal accommodation easily.\n\n- **Room Details Page:** Provide detailed information about each room, including description, price per night, availability, images, special offers, and reviews, facilitating informed booking decisions.\n\n- **Booking System:** Implement a seamless booking process with date selection and a confirmation modal, ensuring users can book available rooms securely and efficiently.\n\n- **My Bookings Page:** Enable users to view and manage their bookings, including cancellation and date modification functionalities, enhancing user control and satisfaction.\n\n- **Review System:** Allow users to post reviews for rooms they have booked, enhancing transparency and facilitating feedback for continuous improvement.\n\n- **Access Control:** Restrict access to certain features like booking and review posting for non-logged-in users, enhancing security and user experience.\n\n- **404 Page:** Create a customized 404 page with an engaging image/gif and a \"Back to Home\" button, ensuring a seamless user experience even in case of navigation errors.\n\n- **Additional Packages:** Implement browser tab title and meta-data updates for improved SEO, integrate animation library Aos for enhanced visual appeal, and utilize MapLibrary for interactive map functionalities.\n\n## Contributing\n\nIf you would like to contribute to this project, please follow these steps:\n\n1. Fork the repository.\n2. Create a new branch.\n3. Make your changes.\n4. Submit a pull request.\n\n## Contact\n\nFor any inquiries, please reach out to Shahadath Hossen Sajib at \u003cshahadathhossensajib732@gmail.com\u003e.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshahadathhs%2Froom-ready-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshahadathhs%2Froom-ready-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshahadathhs%2Froom-ready-client/lists"}