{"id":25227863,"url":"https://github.com/arpitaswal/wanderstay","last_synced_at":"2026-05-05T18:38:08.715Z","repository":{"id":276781698,"uuid":"930257193","full_name":"ArpitAswal/WanderStay","owner":"ArpitAswal","description":"WanderStay is an innovative concept designed to bridge the gap between travellers and hosts, offering an efficient and visually engaging experience. While the current version is a prototype, future enhancements will make it a robust, real-time booking platform that meets industry standards. Stay tuned for upcoming updates!","archived":false,"fork":false,"pushed_at":"2025-02-10T13:25:37.000Z","size":2888,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-05T13:16:20.255Z","etag":null,"topics":["dart","facebook-login","firebase-auth","firebase-firestore-database","flutter","geolocation","google-login","google-maps-api","provider-state-management","sharedpreferences","shimmer-effect"],"latest_commit_sha":null,"homepage":"","language":"Dart","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/ArpitAswal.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-10T10:40:42.000Z","updated_at":"2025-02-10T13:21:40.000Z","dependencies_parsed_at":"2025-02-10T12:42:13.042Z","dependency_job_id":null,"html_url":"https://github.com/ArpitAswal/WanderStay","commit_stats":null,"previous_names":["arpitaswal/wanderstay"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ArpitAswal/WanderStay","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArpitAswal%2FWanderStay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArpitAswal%2FWanderStay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArpitAswal%2FWanderStay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArpitAswal%2FWanderStay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ArpitAswal","download_url":"https://codeload.github.com/ArpitAswal/WanderStay/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArpitAswal%2FWanderStay/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279083424,"owners_count":26099643,"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-10-15T02:00:07.814Z","response_time":56,"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":["dart","facebook-login","firebase-auth","firebase-firestore-database","flutter","geolocation","google-login","google-maps-api","provider-state-management","sharedpreferences","shimmer-effect"],"created_at":"2025-02-11T09:12:46.294Z","updated_at":"2025-10-15T13:32:28.856Z","avatar_url":"https://github.com/ArpitAswal.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"## App Logo\nClick on a logo to download the latest version of the app apk file:\n\n\u003ca href=\"https://github.com/ArpitAswal/WanderStay/releases/download/v1.0.0/WanderStay.apk\"\u003e ![app_logo](https://github.com/user-attachments/assets/ca738837-3753-4ffb-ab1b-4e7413f39179)\n\u003c/a\u003e\n\n# Project Title: WanderStay\n\nWanderStay is a prototype application designed to provide users with an immersive experience of discovering and reserving stay places, similar to Airbnb. The current version is a beta release intended for user experience testing and feedback collection. All data is managed statically using Firebase services, including authentication and Firestore for data storage.\n\nThe app allows users to search and explore rental stay places listed by vendors for various occasions such as holiday getaways, festive seasons, or weekend retreats. Additionally, it features an interactive Google Map that displays available stay locations with markers, making it easier for users to find and evaluate places based on their preferred locations.\n\n## Features\n\n#### Explore Screen\n\n- Displays a list of stay places with essential details, including images, vendor profile, availability date, address, and price per night.\n\n- Provides a search functionality with search suggestions, allowing users to find specific locations effortlessly.\n\n- Categorized listings such as Surfing activity stays, Wooden houses, Amazing view places, Houseboats, etc.\n\n#### Map Screen\n\n- Integrated Google Map displaying location markers for available places, allowing users to visually identify service coverage areas.\n\n- Tapping on a marker reveals essential details like images, addresses, and ratings in a pop-up window.\n\n#### Profile (Account) Screen\n\n- Users must sign in via phone number, email, Google, or Facebook authentication (managed by Firebase) to access full features.\n\n- Displays personal information, security settings, payment and payout options, and a feedback section.\n\n#### Wishlist Screen\n\n- Allows users to see their favourite stay places for future reference.\n\n- Helps users plan and compare multiple locations before making a reservation decision.\n\n#### Message Screen\n\nContains chat sections where users can communicate with:\n\n- Support Team (for help and queries)\n\n- Friends (to share stay details or plan trips together)\n\n- Vendors (to inquire about availability or additional details)\n\n- WanderStay Service Team\n\n(These five screens are are main screens and managed via a bottom navigation bar)\n\n#### Place Detail Screen\n\n- Displays comprehensive information when a user selects a stay place from Explore, Wishlist, or Google Maps.\n\n- Includes place images, addresses, ratings, reviews, service lists, vendor descriptions, and map location.\n\n## Challenges\n\n- Ensuring seamless UI/UX to enhance user engagement and app approval for further development.\n\n#### Future Challenges\n\n- Managing real-time data from APIs while maintaining performance and responsiveness.\n\n- Handling user location tracking for navigation from source to destination.\n\n- Securely integrating a payment gateway for hassle-free reservations.\n\n## Future Enhancements\n\n#### API Integration\n\n- Replacing static Firebase data with dynamically fetched data from APIs for real-time listings and updates.\n\n- Optimizing UI to adapt based on user interactions.\n\n#### Real-Time User Location Tracking\n\n- Implementing features to track users from source to destination with optimized travel paths.\n\n- Enhancing map functionalities for a better navigational experience.\n\n#### Payment Gateway Implementation\n\n- Ensuring secure and smooth transactions between users and WanderStay service accounts.\n\n- Allowing users to reserve places by selecting available dates and making payments.\n\n## Installation\n\nTo run this project locally:\n\n- Clone the repository:\n  git clone https://github.com/ArpitAswal/WanderStay.git\n\n- Navigate to the project directory:\n  cd WanderStay\n\n- Install dependencies:\n  flutter pub get\n\n- Set up the Google API Key at Manifest file and the required permissions\n\n- Run the app:\n  flutter run\n\n## Note\n\n- This is a prototype application that currently displays static data from Firebase.\n\n- The primary goal is to test user experience, interface design, and core functionality before moving towards a fully functional production app.\n\n- User has to provide the access of getting location to get the Google Map service on app, so they can easily see the stay locations and their current location.\n\n- we have to link the google and email provider to sign in with same email and by sign in with facebook I don't have a access of getting a email so I built a temporary logic with the help of shared preferences.\n\n## Usage Flow\n\n#### Launch App:\n\n- Displays the SplashScreen with the app logo, name, and motto.\n\nhttps://github.com/user-attachments/assets/9a289c0d-5b23-4b84-b49e-70d76397a4a3\n\n#### Guest Access (Without Sign-In):\n\n- Users can only access the Explore Screen (limited functionality) and the Account Screen (for sign-in/sign-up options).\n  \n- Limited access prevents users from viewing full location details, using search functionality, or checking reservation status.\n  \n  ![photo_2_2025-02-10_16-40-53](https://github.com/user-attachments/assets/2d6cbb46-104a-4cf4-a06e-e09e19170cb8)\n\n  https://github.com/user-attachments/assets/7ae1328b-45b4-4b25-b175-91e4b437506c\n  \n  ![photo_2025-02-10_16-47-22](https://github.com/user-attachments/assets/655c1e67-fd44-4b39-8af7-3080e17112e8)\n\n#### After Sign-In:\n\n- Users gain access to the five main screens (Explore, Wishlist, Google Map, Messages, Profile).\n\n- Viewing Stay Locations on Google Maps by tapping on a markers\n\nhttps://github.com/user-attachments/assets/f6f6e7a2-520b-44a3-a335-9e7c3be4447b\n\n![photo_3_2025-02-10_16-40-53](https://github.com/user-attachments/assets/539b7087-c5b6-4d72-a311-17d99817f6a3)\n\n![photo_4_2025-02-10_16-40-53](https://github.com/user-attachments/assets/0a4475a7-e43d-424a-82bc-dd679d7be528)\n\n![photo_2025-02-10_16-55-16](https://github.com/user-attachments/assets/c45bd87e-3bdc-4ddb-a9ff-a674a340cece)\n\nhttps://github.com/user-attachments/assets/2b64408e-0641-4cf4-97eb-1a6abac07f99\n\nhttps://github.com/user-attachments/assets/b7761718-6586-45e5-80ea-a65cd9fc26eb\n\n#### Viewing Place Details:\n\n- Users can access the Place Detail Screen by selecting a stay place from Explore and Wishlist.\n\nhttps://github.com/user-attachments/assets/1b443f9e-7fe2-40a7-82f1-7cb289854351\n\n## Tech Stack\n\n- Flutter: The primary framework for building the mobile application.\n\n- Dart: The programming language used with Flutter.\n\n- Google Map Key: To run the map on devices.\n\n- Firebase: To provide the Authentication and Firestore database service\n\n## Packages Used\n\n-  cupertino_icons: ^1.0.8 # Provides Cupertino (iOS-style) icons for Flutter apps.\n-  google_maps_flutter: ^2.9.0 # A Flutter plugin for integrating Google Maps into your application.\n-  another_carousel_pro: ^1.0.2 # A carousel widget for displaying a scrollable list of images or other widgets.\n-  custom_info_window: ^1.0.1 # A package for creating custom info windows for markers on Google Maps.\n-  firebase_core: ^3.6.0 # The core Firebase SDK for Flutter, required for other Firebase services.\n-  cloud_firestore: ^5.4.4 # A Flutter plugin for using Cloud Firestore, a NoSQL database from Firebase.\n-  firebase_auth: ^5.3.1 # A Flutter plugin for Firebase Authentication, allowing user sign-up and sign-in.\n-  google_sign_in: ^6.2.1 # A Flutter plugin for integrating Google Sign-In into your app.\n-  provider: ^6.1.2 # A package for state management in Flutter, making it easy to share data and rebuild widgets.\n-  flutter_plugin_android_lifecycle: ^2.0.24 # A plugin to access Android lifecycle events from Flutter.\n-  persistent_bottom_nav_bar: ^6.2.1 # A customizable persistent bottom navigation bar for Flutter apps.\n-  animated_text_kit: ^4.2.3 # A package for creating various text animations in Flutter.\n-  google_fonts: ^6.2.1 # A package for easily using Google Fonts in your Flutter applications.\n-  flutter_rating_bar: ^4.0.1 # A widget for displaying and interacting with a rating bar.\n-  location: ^6.0.1 # A package for accessing device location services in Flutter.\n-  flutter_circular_text: ^0.3.1 # A widget for displaying text along a circular path.\n-  marquee: ^2.3.0 # A widget for creating scrolling text (marquee effect) in Flutter.\n-  encrypt_shared_preferences: ^0.8.7 # A package for encrypting data stored in shared preferences.\n- flutter_facebook_auth: ^7.1.1 # A Flutter plugin for integrating Facebook Authentication.\n-  cached_network_image: ^3.4.1 # A package for displaying and caching network images in Flutter.\n-  shimmer: ^3.0.0 # A package for adding shimmer (loading) effects to widgets in Flutter.\n-  animate_do: ^3.3.7 # A package for easily adding various animations to widgets in Flutter.\n-  geolocator: ^13.0.2 # A package for retrieving the user's geolocation in Flutter.\n\n## Feedback\n\n- If you have any feedback, please reach out to me at arpitaswal995@gmail.com\n\n- If you face an issue, then open an issue in a GitHub repository.\n\n## Contributing\n\nContributions are always welcome!\n\n#### Fork the Repository:\n\n- Go to the original repository on GitHub or GitLab.\n- Click the \"Fork\" button. This creates a copy of the repository under your own account.\n\n#### Create a New Branch:\n- Clone your forked repository to your local machine: git clone \u003cyour_fork_url\u003e\n- Create a new branch for your feature: git checkout -b feature-branch\n- Replace feature-branch with a descriptive name for your changes (e.g., fix-bug, add-feature).\n\n#### Make Changes and Commit:\n- Make the necessary changes to the code in your local feature-branch.\n- Stage the changes: git add \u003cfiles\u003e (or git add . to stage all changes)\n- Commit the changes with a clear message: git commit -m \"Add new feature\"\n- Use a descriptive and concise message that explains the changes.\n\n#### Push Changes to Your Fork:\n- Push your feature-branch to your remote repository: git push origin feature-branch\n\n#### Create a Pull Request:\n- Go back to the original repository on GitHub or GitLab.\n- Click the \"New Pull Request\" button.\n- Select your feature-branch as the source and the original repository's main or develop branch as the target.\n- Provide a clear description of your changes and why they are needed.\n- Submit the pull request.\n\n\n## Conclusion\n\nWanderStay is an innovative concept designed to bridge the gap between travellers and hosts, offering an efficient and visually engaging experience. While the current version is a prototype, future enhancements will make it a robust, real-time booking platform that meets industry standards. Stay tuned for upcoming updates!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farpitaswal%2Fwanderstay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farpitaswal%2Fwanderstay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farpitaswal%2Fwanderstay/lists"}