PriyaGhosal / BuddyTrail

This repository is officially part of GirlScript Summer of Code 2024 Extended Edition !
https://buddytrail.netlify.app/
MIT License
137 stars 358 forks source link
css firebase gssoc-ext hacktoberfest-accepted html javascript
# `🏞️ BuddyTrail` Welcome to **BuddyTrail** – your ultimate travel companion! 🌍✈️ Whether you're planning a family vacation πŸ‘¨β€πŸ‘©β€πŸ‘§β€πŸ‘¦ or a trip with friends πŸ‘«, BuddyTrail helps you discover and explore amazing destinations πŸ–οΈπŸ°, find the best hotels 🏨, and book affordable flights πŸ’Ί with ease.

🌟 Stars 🍴 Forks πŸ› Issues πŸ”” Open PRs πŸ”• Close PRs πŸ› οΈ Languages 🌐 Contributors
Stars Forks Issues Open Pull Requests Close Pull Requests GitHub language count GitHub contributors


This project is now OFFICIALLY accepted for

Event Logo Event Name Event Description
GSSoC 24 GirlScript Summer of Code Extended 2024 GirlScript Summer of Code Extended is a month-long Open Source Program conducted by GirlScript Foundation. It is an initiative to bring more beginners to Open-Source Software Development.
Hacktoberfest 2024 Hacktoberfest 2024 Hacktoberfest is a month-long celebration of open source software run by DigitalOcean, GitHub, and Twilio. It encourages contributions to open source projects and promotes a global community of developers.


πŸ“‹ Table of Contents

πŸ“Έ Website Preview

https://github.com/user-attachments/assets/35baa356-0d03-4aa8-9f79-db78244397ee

Screenshot 2024-10-19 143805

Screenshot 2024-10-19 143906

Screenshot 2024-10-19 143959


πŸš€ Features

πŸ—ΊοΈ Interactive Travel Map: Explore popular destinations across India and around the world. Click on markers to learn more about each location.

πŸŒ™πŸŒž Dark & Bright Mode: Switch between dark and bright modes for a comfortable browsing experience, day or night.

🏨 Hotel Finder: Find the best hotels at affordable rates, handpicked to suit your budget and preferences.

✈️ Flight Booking: Book flights at the best prices, with options tailored to your travel needs.

πŸ“ Travel Blog: Read tips, guides, and personal stories from seasoned travelers.

🌐 Multi-Language Support: View the website in multiple languages, catering to a global audience.

⭐ User Reviews and Ratings: Read and leave reviews for destinations, hotels, flights, and activities.


πŸ› οΈ Technologies Used

πŸ“ HTML/CSS: For building and styling the website structure.

βš™οΈ JavaScript: For interactive features like the map and mode toggling.

πŸ—ΊοΈ Google Maps API: For displaying the interactive travel map.

πŸ“± Responsive Design: The website is fully responsive and works on all devices.


πŸ“‘ API Documentation

Overview

The BuddyTrail API allows you to interact with travel data, including destinations, hotels, and flights.

Endpoints

🌍 Get Destinations

🏨 Get Hotels

✈️ Book Flight

Usage Example

curl -X GET "https://api.buddytrail.com/api/destinations"

πŸ“œ Response Format

All responses are in JSON format. Ensure to handle errors appropriately.

πŸ›€οΈ Project Roadmap

Our roadmap outlines the future features and enhancements planned for BuddyTrail. We are committed to continuously improving your travel experience! πŸš€

Quarter Feature Description Status
Q4 2024 🌍 Enhanced Destination Search Introduce advanced filters and suggestions for popular travel destinations. In Progress
Q1 2025 ✈️ Flight Comparison Tool Allow users to compare flight options side-by-side to find the best deals. Planned
Q2 2025 🏨 Hotel Booking Integration Integrate with hotel booking platforms for real-time availability and pricing. Planned
Q3 2025 πŸ“± Mobile App Launch Launch a mobile app version of BuddyTrail for on-the-go planning and booking. Planned
Q4 2025 🌐 Multi-Language Support Expand language options to cater to a broader international audience. Planned
Q1 2026 πŸ“– Travel Blog Feature Implement a community-driven travel blog where users can share experiences and tips. Future

Stay tuned for updates as we work to bring these features to life! πŸŽ‰

πŸŽ‰ Welcome Contributors!! πŸ‘¨β€πŸ’»πŸ‘‹

Join the list. We are waiting
Here's how you can contribute to the repository:

  1. Fork this Repository 🍴

  2. Clone to your local machine 🧩 using:

    git clone https://github.com/Your-Username/BuddyTrail.git
  3. Create a new branch:

    git branch -c "Feature-Name"
  4. Navigate to the branch:

    git checkout Feature-Name
  5. Add changes and Commit:

    git commit -m "Add Changes message"
  6. Push to the branch:

    git push origin Feature-Name
  7. Submit Pull Request

We welcome all contributions to improve BuddyTrail! If you would like to contribute, please follow the Contributing.md for more details on how to get started.

To maintain quality and consistency, please adhere to the following guidelines:

  1. Code Style: Follow the coding style used throughout the project. Clean, readable code with comments is always appreciated.
  2. Commits: Write meaningful commit messages.
  3. Pull Requests: Make sure PRs are focused, well-explained, and reference any issues they address.
  4. Testing: Ensure that your changes are well-tested locally and don’t break existing functionality.

Project-strucutre πŸ“

You can find the project structure in the Project Structure file. It contains the details of the project structure and the files present in the project. It will help you to understand the project structure better. πŸ—‚οΈ

πŸ‘₯ Team

Priya Ghosal
Priya Ghosal
Project Admin
LinkedIn Discord Twitter GitHub

For any inquiries or feedback, please contact. Happy Contributing 🫑

Our Contributors

Thank you for contributing to our repository

↳ Stargazers

[![Stargazers repo roster for @PriyaGhosal/BuddyTrail](https://reporoster.com/stars/PriyaGhosal/BuddyTrail)](https://github.com/PriyaGhosal/BuddyTrail/stargazers)

↳ Forkers

[![Forkers repo roster for @PriyaGhosal/BuddyTrail](https://reporoster.com/forks/PriyaGhosal/BuddyTrail)](https://github.com/PriyaGhosal/BuddyTrail/network/members)
Star History Chart
Back to Top

⭐️ Support the Project

If you find this project helpful, please consider giving it a ⭐ on GitHub! Your support helps to grow the project and reach more contributors.

Thanks for reading!!!