Skip to content

Wanderlust is a full-stack MARN stack application designed to provide a platform similar to Airbnb

License

Notifications You must be signed in to change notification settings

BalramApply/wanderlust

Repository files navigation

🌏 Wanderlust

Wanderlust Logo


Overview

Wanderlust is a full-stack MARN stack application designed to provide a platform similar to Airbnb, where users can search for accommodations, make bookings, and leave reviews. With a sleek and intuitive interface, Wanderlust aims to make finding and booking your next adventure easy and enjoyable.


Table of Contents



📑 Features

  • User authentication and authorization
  • View detailed listings with photos, descriptions, and reviews
  • Make bookings and manage reservations
  • Post and view reviews of accommodations
  • Responsive design for seamless experience on all devices

🔧 Technologies

Front-end

  • HTML: displayed in a web browser.
  • CSS: describing the presentation.
  • Bootstrap: A front-end framework.
  • JavaScript: frontend and backend development.
  • EJS: HTML markup with plain JavaScript.

Back-end

  • Node.js: server-side scripting.
  • Express.js: framework for Node.js
  • MongoDB: Database
  • Passport: authenticate requests.
  • MVC Freamwork: used to structure the backend.

Hosting

  • Cloudinary: entire image management pipeline.
  • Multer: primarily used for uploading files.
  • Atlas: MongoDB Atlas is a fully-managed cloud database.
  • Render: Deploy Our Project

⚙️ Installation

  1. Clone the repository

    git clone https://github.com/yourusername/wanderlust.git
    cd wanderlust
  2. Install dependencies

    npm install
    cd client
    npm install
    cd ..
  3. Set up environment variables Create a .env file in the root directory and add the following:

    CLOUD_NAME=cloude_name
    CLOUD_API_KEY=cloud_api_key
    CLOUD_API_SECRET=cloud_api_secret
    ATLASDB_URL=atlas_db
    SECRET=secret
  4. Run the application

    npm run dev

🚀 Usage

  1. Register and log in to access all features.
  2. Creating Listings by entering a Various Fields.
  3. View accommodation details including photos, descriptions, and reviews.
  4. Updating Listing Anything that you want to updates
  5. Leave a review after your stay.

📸 Screenshots

Homepage Homepage

Search Results Log In

Listing Details Sign Up

Listing Details Listing

Listing Details Review


🤝 Contributing

Contributions are welcome! Please fork the repository and create a pull request with your changes. Ensure your code follows the project's coding standards and include relevant tests.

  1. Fork the repository
  2. Create your feature branch
    git checkout -b feature/YourFeature
  3. Commit your changes
    git commit -m 'Add YourFeature'
  4. Push to the branch
    git push origin feature/YourFeature
  5. Open a pull request

📜 License

This project is licensed under the MIT License. See the LICENSE file for details.


📞 Contact

For any questions or suggestions, please reach out to:


Happy wandering with Wanderlust!