🌍 Wanderlust-2024

Wanderlust is a comprehensive travel platform designed for adventurers and explorers who want to discover and share extraordinary places around the world. Built with the powerful MERN (MongoDB, Express, React, and Node.js) stack, Wanderlust offers a seamless and secure user experience for both casual travelers and serious wanderers.

Our platform allows users to:✨

• Create and Manage Listings: Add new travel destinations with rich details and photos, and keep track of your own adventures.
  
• Explore Listings: Discover unique spots shared by other users, complete with interactive maps powered by Mapbox.
  
• Review and Rate Experiences: Share your thoughts on destinations you've visited or learn from the experiences of others through our review system.
  
• Secure Authentication: Enjoy a safe browsing and sharing environment with user authentication handled by Passport.
  
• Interactive Maps: Visualize locations effortlessly with Mapbox integration, making it easier to plan your next getaway.
  Wanderlust is all about making travel planning fun, efficient, and collaborative. Whether you’re adding a hidden gem or exploring a bustling city, our platform connects you to a global community of travelers. ✈️✨
  

Live Link: https://wanderlust-2024-tkqf.onrender.com/listing

📈 GitHub Repository Stats

🌟 Stars	🍴 Forks	🐛 Issues	🔔 Open PRs	🔕 Closed PRs	🛠️ Languages	✅ Contributors

📚 Table of Contents

• 🤝 How to Contribute
• 🛠️ How to Set Up the Project Locally
• 📬 Contact
• 👀 Our Valuable Contributors
• ❤️ Made with Love by Soujanya C

🤝 How to Contribute

We welcome contributions to help improve Wanderlust 2024! 🚀 Here’s how you can get involved:

1. Fork the Repository 🍴

   • Navigate to the Wanderlust 2024 GitHub page. 🌐
   • Click on the Fork button in the top-right corner of the page to create a copy of the repository in your GitHub account. ➕

2. Clone Your Forked Repository 🔄

   • After forking, clone the repository to your local machine:

     git clone https://github.com/your-username/Wanderlust-2024.git

   • Navigate to the project directory:

     cd Wanderlust-2024

3. Create a New Branch for Your Changes 🌿

   • Create a new branch for your feature or fix:

     git checkout -b feature/your-feature-name

4. Make Your Changes ✏️

   • Add your desired features, fix bugs, or improve documentation. 🛠️

5. Add Your Changes to the Staging Area 📦

   • Stage the files you modified or created:

     git add .

6. Commit Your Changes 📝

   • Commit your changes with a descriptive message:

     git commit -m "Add [feature/fix] - description"

7. Push Your Changes ⬆️

   • Push the changes to your forked repository:

     git push origin feature/your-feature-name

🛠️ How to Set Up the Project Locally

1. Clone the Repository 🔍

   • Clone the repository to your local machine:

     git clone https://github.com/your-username/Wanderlust-2024.git

2. Navigate to the Project Directory 📂

   • Change to the directory where the project is located:

     cd Wanderlust-2024

3. Set Up Your Mapbox Account 🌐

   • Go to Mapbox and sign up for a free account. 🆓
   • After logging in, navigate to the Tokens section under your account settings. 🔑
   • Create a new Access Token and copy it. You will need this for the .env file. 📄

4. Set Up Your Cloudinary Account ☁️

   • Go to Cloudinary and sign up for a free account. 🆓
   • After logging in, navigate to your Dashboard. 📊
   • Copy your Cloud Name, API Key, and API Secret. You will need these for the .env file. 🔐

5. Ensure .env and node_modules/ Are in .gitignore 🛡️

   • Before proceeding, ensure that both .env and node_modules/ are added to your .gitignore file to prevent sensitive information and large files from being uploaded to GitHub. 🚫
   • If they are not already there, add them:

     echo .env >> .gitignore
     echo node_modules/ >> .gitignore

6. Create a .env File 🗃️

   • In the root directory of the project, create a .env file and add the following variables:

     MAP_TOKEN=your-mapbox-access-token
     ATLAS_DB_TOKEN=your-mongodb-connection-uri # mongodb://127.0.0.1:27017/wanderlust for running mongodb server locally
     SECRET=your-secret-key
     CLOUD_NAME=your-cloudinary-cloud-name
     CLOUD_API_KEY=your-cloudinary-api-key
     CLOUD_API_SECRET=your-cloudinary-api-secret
     PORT=8080 # Default port for the server
     

7. Install Dependencies ⚙️

   • Install the required Node.js dependencies:

     npm install

8. Start the Server 🚀

   • You have two options to start the server:
     • Using npx nodemon for auto-restarting:

       npx nodemon

     • Or using node app.js to start the server manually:

       node app.js

9. Environment Setup 🔒

   • Ensure that the .env file is not uploaded to GitHub by checking that .gitignore includes .env. 📜 The following code snippet prevents .env from being deployed if you're running in development mode:

     if (process.env.NODE_ENV !== 'production') {
       require('dotenv').config();
     }

10. Set Up Your Chatbase Account ☁️

    • Go to Chatbase.co and sign up for a free account. 🆓
    • After logging in, Create your chatbot. 📊
    • Copy your Scrtpt code snippet, You will need theie for the Chat bot implementation in boilerplate.ejs file. 🔐

Feel free to raise issues and contribute to the repository! 🎉💻

🤝 Join Our Community of Contributors!

We're excited to have you on board! Whether you're a seasoned developer or just starting out, your skills and ideas can make a significant impact on Wanderlust 2024. Here’s how you can get involved:

• Share Your Ideas 💡: Have a feature in mind? Let us know!
• Fix Bugs 🐛: Help us improve the project by identifying and fixing issues.
• Enhance Documentation 📚: Clear documentation helps everyone. Your contributions can make it even better!

Every contribution, big or small, is valued and appreciated. Together, we can create an amazing platform for travel enthusiasts! 🌍✨

👀 Our Valuable Contributors 💖✨

📬 Contact

For questions or feedback, feel free to reach out via GitHub issues or contact the project maintainers. ✉️

❤️ Made with Love by Soujanya C

Thank You for Your Support! 💖

Your contributions help us grow and improve! Happy Coding ✨🚀