🌍 WanderLust

A full-stack vacation rental platform where users can browse, list, and review properties - similar to Airbnb. Built with Node.js, Express, and MongoDB.

🚀 Features

• 🏠 Property Listings: Create, read, update, and delete vacation rental listings
• 🔐 User Authentication: Secure signup/login with Passport.js
• ⭐ Reviews & Ratings: Users can leave reviews and ratings for properties
• 🗺️ Interactive Maps: Mapbox integration for location visualization
• 🖼️ Image Upload: Cloud-based image storage with Cloudinary
• 🏷️ Categories: Filter properties by categories (Beach, Mountain, Castles, etc.)
• 📱 Responsive Design: Mobile-friendly UI
• 🔒 Authorization: Owner-only edit/delete permissions
• 💬 Flash Messages: User-friendly notifications
• ✅ Data Validation: Server-side validation with Joi

🛠️ Tech Stack

Backend

• Node.js - Runtime environment
• Express.js - Web application framework
• MongoDB Atlas - Cloud database
• Mongoose - MongoDB object modeling

Authentication

• Passport.js - Authentication middleware
• Passport-Local - Local authentication strategy
• Passport-Local-Mongoose - Mongoose plugin for user authentication

Storage & APIs

• Cloudinary - Image hosting and management
• Mapbox SDK - Maps and location services
• Multer - File upload handling

Templating & Session

• EJS - Embedded JavaScript templating
• EJS-Mate - Layout support for EJS
• Express-Session - Session management
• Connect-Mongo - MongoDB session store
• Connect-Flash - Flash messages

Validation & Utilities

• Joi - Schema validation
• Method-Override - HTTP verb support (PUT, DELETE)
• Dotenv - Environment variable management

📁 Project Structure

WanderLust/
├── app.js                 # Main application entry point
├── package.json           # Dependencies and scripts
├── cloudConfig.js         # Cloudinary configuration
├── middleware.js          # Custom middleware functions
├── schema.js              # Joi validation schemas
├── vercel.json           # Vercel deployment config
│
├── controllers/          # Route controllers (MVC)
│   ├── listings.js       # Listing CRUD logic
│   ├── reviews.js        # Review logic
│   └── users.js          # User authentication logic
│
├── models/              # Database models
│   ├── listing.js       # Listing schema
│   ├── review.js        # Review schema
│   └── user.js          # User schema
│
├── Router/              # Express routes
│   ├── listing.js       # Listing routes
│   ├── review.js        # Review routes
│   └── user.js          # User routes
│
├── views/               # EJS templates
│   ├── layouts/         # Layout templates
│   ├── listing/         # Listing views
│   ├── users/           # Auth views
│   └── includes/        # Reusable components
│
├── public/              # Static assets
│   ├── CSS/            # Stylesheets
│   ├── JS/             # Client-side scripts
│   └── images/         # Static images
│
├── Utils/              # Utility functions
│   ├── ExpressError.js # Custom error handler
│   └── wrapAsync.js    # Async error wrapper
│
└── init/               # Database initialization
    ├── data.js         # Sample data
    └── index.js        # Data seeding script

🏗️ Architecture

The project follows the MVC (Model-View-Controller) pattern:

• Models: Define data structure using Mongoose schemas
• Views: EJS templates for rendering HTML
• Controllers: Business logic for handling requests
• Routes: Define API endpoints and map to controllers

🔧 Installation & Setup

Prerequisites

• Node.js (v20 or higher)
• MongoDB Atlas account
• Cloudinary account
• Mapbox account

Environment Variables

Create a .env file in the root directory:

# MongoDB
ATLASDB_URL=your_mongodb_atlas_connection_string

# Cloudinary
CLOUD_NAME=your_cloudinary_cloud_name
CLOUD_API_KEY=your_cloudinary_api_key
CLOUD_API_SECRET=your_cloudinary_api_secret

# Mapbox
MAP_TOKEN=your_mapbox_access_token

# Session Secret
SECRET=your_session_secret_key

Installation Steps

1. Clone the repository

   git clone https://github.com/prathampmp23/Wanderlust
   cd WanderLust

2. Install dependencies

   npm install

3. Set up environment variables

   • Create .env file with required variables

4. Initialize database (optional)

   node init/index.js

5. Run the application

   For development:

   npm run dev

   For production:

   npm start

6. Access the application

   http://localhost:8080
   

🎯 How It Works

User Flow

1. Registration/Login: Users create an account or log in
2. Browse Listings: View all properties with filters by category
3. View Details: Click on a listing to see full details, location on map, and reviews
4. Create Listing: Authenticated users can add new properties with images
5. Leave Reviews: Users can rate and review properties
6. Manage Listings: Owners can edit or delete their own listings
7. Manage Reviews: Users can delete their own reviews

Key Features Implementation

Authentication Flow

• Uses Passport.js with local strategy
• Passwords hashed using passport-local-mongoose
• Session-based authentication with MongoDB store

Image Upload

• Multer handles multipart/form-data
• Images stored in Cloudinary cloud storage
• Automatic format validation (png, jpg, jpeg)

Map Integration

• Mapbox SDK for geocoding addresses
• Interactive maps on listing detail pages
• Location markers for each property

Authorization

• Custom middleware checks ownership
• Users can only edit/delete their own listings/reviews
• Logged-in requirement for certain routes

Validation

• Client-side: HTML5 form validation
• Server-side: Joi schema validation
• Error handling with custom ExpressError class

🚀 Deployment

The project is configured for deployment on Vercel:

• vercel.json contains deployment configuration
• Environment variables must be set in Vercel dashboard
• MongoDB Atlas provides cloud database
• Cloudinary hosts images

📦 Available Scripts

• npm start - Run production server
• npm run dev - Run development server with nodemon
• npm test - Run tests (not configured yet)

🔒 Security Features

• Password hashing with salt
• Session secret protection
• CSRF protection via Express session
• Input validation and sanitization
• Secure HTTP headers
• MongoDB injection prevention

🎨 Categories Available

• Trending
• Rooms
• Cities
• Beach
• Cabins
• Castles
• Mountain
• View
• Pool
• Farm
• Arctic
• Golfing
• Boat

📄 License

This project is licensed under the ISC License.

🤝 Contributing

Contributions, issues, and feature requests are welcome!

---

Made with ❤️ by Pratham Potdar