Skip to content

Ananta025/Nest-Finder

Repository files navigation

🏠 Nest Finder Web App

🌟 Overview

Welcome to Nest Finder, your go-to web application for finding and managing stays effortlessly. This is a feature-rich Nest Finder web application designed to provide users with a seamless experience for booking stays, exploring locations, and interacting with listings. The app includes authentication, review features, and map integration, ensuring a modern and user-friendly interface.

🌐 Live Demo: Check it out here:   Nest Finder

✨ Features

🔑 User Authentication

  • 🔐 Login/Signup: Secure user authentication with options for account creation and login.
  • 🚪 Logout: Users can safely log out of their accounts.

📋 Listings Management

  • ➕ Add a New Listing: Registered users can add new property listings with relevant details.
  • 💬 Review Listings: Users can leave reviews on available listings, fostering a community-driven rating system.

🗺️ Map Integration

  • Integrated map functionality allows users to view the exact location of listings, providing a visual representation of where they will stay.

🛠️ Technology Stack

  • Frontend: HTML, CSS, JavaScript, Bootstrap
  • Templating Engine: EJS
  • Backend: Node.js
  • Database: MongoDB
  • Authentication: Passport.js
  • Map Integration: Mapbox

🚀 Installation and Setup

📋 Prerequisites

  • Ensure Node.js and npm are installed.
  • Set up a compatible database.

🛠️ Steps

  1. Clone the repository:
    git clone https://github.com/your-repo-name/nest-finder.git
  2. Navigate to the project directory:
    cd nest-finder
  3. Install dependencies:
    npm install
  4. Set up environment variables in a .env file:
     NODE_ENV=development
     MAP_TOKEN=your_mapbox_token
     CLOUDE_NAME=your_cloudinary_name
     CLOUDE_API_KEY=your_cloudinary_api_key
     CLOUDE_API_SECRET=your_cloudinary_api_secret
     SECRET=your_session_secret
  5. Initialize the database:
    node init/index.js
  6. Start the development server:
    npm start
  7. Open your browser and navigate to http://localhost:8080.

📖 Usage

  • 🔓 Create an account or log in to an existing account.
  • 🏘️ Add new property listings, providing all required details.
  • 🗺️ Explore listings on the integrated map and read reviews.
  • ✍️ Leave reviews for the listings you have interacted with.

📸 Screenshots

Include screenshots of the following:

  1. 🏠 Home Page: Displaying featured listings and navigation options.
  2. 🔑 Login/Signup Page: Highlighting the authentication process.
  3. 📋 Add Listing Page: Showcasing the form to add a new listing.
  4. 🗺️ Map Integration: Visual representation of the location feature.

🔮 Future Enhancements

  • 🔍 Advanced Search Filters: Enable search by price, amenities, and availability.
  • ❤️ Wishlist Feature: Allow users to save their favorite listings.
  • 🛠️ Admin Panel: For managing listings and user accounts.
  • 💬 Messaging System: Facilitate communication between hosts and guests.

🤝 Contribution

Contributions are welcome! Please follow these steps:

  1. Fork the repository.
  2. Create a new branch:
    git checkout -b feature-name
  3. Commit your changes:
    git commit -m "Add your message here"
  4. Push to the branch:
    git push origin feature-name
  5. Create a pull request.

📜 License

This project is licensed under the MIT License.


📧 Contact

For any questions or suggestions, please contact:

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published