Real Estate Web Application

Real Estate Web Application

---

📋 Table of Contents

• 🎯 About The Project
• ✨ Features
• 🛠️ Tech Stack
• 🎪 Demo
• 🔧 Installation
• ⚙️ Environment Variables
• 📂 Folder Structure
• 🚀 API Documentation
• 📜 License

---

About The Project

Real Estate Web Application is a comprehensive MERN stack project that enables users to browse, search, and manage property listings with a modern, responsive interface. Built as a full-stack demonstration of contemporary web development practices, featuring secure authentication, dynamic content management, and an intuitive user experience.

The project aims to provide a professional property browsing platform that showcases skills in frontend development, backend API design, database integration, and modern UI/UX principles.

---

Features

• 🏠 Browse property listings with detailed information and image galleries
• 🔍 Advanced Search & Filtering by price range, location, and property type
• 📝 Property Management - Add, edit, and delete listings with form validation
• 🔐 User Authentication - Secure registration and login system
• 💬 Interactive Chatbot - Predefined Q&A system for user assistance
• 📱 Fully Responsive Design - Optimized for desktop, tablet, and mobile devices
• ⚡ Smooth Animations - Enhanced UX with Framer Motion transitions
• 💾 Data Persistence - Secure MongoDB integration for all user and property data

---

Tech Stack

---

Demo

Check out the live project here: Real Estate Web Application Live Demo

GitHub repository: Real Estate GitHub

---

Installation

1. Clone the repo:

git clone https://github.com/pran-ekaiva006/real-estate.git

Install dependencies:

Frontend

cd real-estate/client
npm install

Backend

cd ../server
npm install

Run the application:

Frontend

cd client
npm run dev

Backend

cd ../server
npm start

The application will be available at http://localhost:5173 (frontend) with the API running on http://localhost:5001.

---

⚙️ Environment Variables

Create .env files in both directories:

Client (client/.env):

VITE_API_BASE_URL=http://localhost:5001

Server (server/.env):

MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret_key
PORT=5001
NODE_ENV=development

---

📂 Folder Structure

real-estate-main/
├── .gitignore
├── LICENSE
├── README.md
├── client/                 # Frontend React application
│   ├── .eslintrc.cjs
│   ├── index.html
│   ├── package-lock.json
│   ├── package.json
│   ├── tailwind.config.js
│   ├── vite.config.js
│   ├── public/            # Static assets
│   │   ├── hero-image.png
│   │   ├── logo.png
│   │   └── vite.svg
│   └── src/
│       ├── App.css
│       ├── App.jsx
│       ├── index.css
│       ├── main.jsx
│       ├── components/    # Reusable React components
│       │   ├── custom/
│       │   │   ├── Header.jsx
│       │   │   ├── Footer.jsx
│       │   │   └── PropertyCard.jsx
│       │   └── ui/
│       │       ├── button.jsx
│       │       ├── input.jsx
│       │       └── dialog.jsx
│       ├── pages/         # Page components
│       │   ├── Home.jsx
│       │   ├── Properties.jsx
│       │   ├── PropertyDetail.jsx
│       │   └── Dashboard.jsx
│       ├── api/          # API service functions
│       │   └── PropertyService.js
│       ├── context/      # React Context
│       │   └── AuthContext.jsx
│       └── utils/        # Utility functions
│           └── helpers.js
│
└── server/                # Backend Node.js application
    ├── controllers/       # Route handlers
    │   ├── authController.js
    │   └── propertyController.js
    ├── models/           # Database models
    │   ├── User.js
    │   └── Property.js
    ├── routes/           # API routes
    │   ├── auth.js
    │   └── properties.js
    ├── middleware/       # Custom middleware
    │   └── authMiddleware.js
    ├── utils/           # Utility functions
    │   └── database.js
    ├── server.js        # Application entry point
    └── package.json

---

Additional Features

• File Upload: Property images upload with validation
• Pagination: All list endpoints support pagination
• Filtering: Advanced filtering by price, location, property type
• Authentication: JWT-based secure authentication system

---

License

This Project is Licensed under the MIT License, see LICENSE for details.