🏠 UrbanShift

A Modern Real Estate & Relocation Platform
Buy, Sell, Rent Properties & Book Packers-Movers — All in One Place!

🌐 Live Demo • ✨ Features • 📸 Screenshots • 🛠️ Tech Stack • 📦 Installation

---

📖 Overview

UrbanShift is a full-stack real estate platform that connects property buyers, sellers, and renters. It also offers integrated Packers & Movers services for seamless relocation. Built with modern technologies for a smooth, responsive experience across all devices.

---

✨ Features

🏠 Property Management

• 📝 List properties for Rent or Sale
• 🖼️ Multi-image upload with automatic compression (Cloudinary)
• 🔍 Advanced property search & filters
• ❤️ Wishlist / Favorite properties
• 📱 Mobile-responsive property gallery with swipe gestures

👤 User System

• 🔐 JWT Authentication (Login/Register)
• 🌐 Google OAuth (Continue with Google)
• 📧 Email Verification via OTP (Brevo)
• 🔑 Forgot/Reset Password
• 🖼️ User Profile with avatar upload
• ✅ Seller Verification by Admin

📊 Dashboards

• 🏪 Seller Dashboard — Manage listings, track leads
• 🛒 User Dashboard — View purchases & bookings
• 🚚 Company Dashboard — Manage relocation requests
• 👑 Admin Panel — Verify users, manage properties (Jazzmin UI)

🚛 Packers & Movers

• 📦 Book relocation services
• 💬 Real-time Chat with service providers
• 📄 Digital Receipts & booking history
• 💳 Razorpay Payments integration
• 🎉 Beautiful success animations (Confetti!)

🎨 User Experience

• 🌗 Dark/Light/System Theme toggle
• ⚡ Splash screen with animations
• 📲 PWA Ready — Installable on mobile
• 🔔 Toast notifications
• 📊 Vercel Speed Insights

---

� Screenshots

📌 A glimpse of the UrbanShift experience:

1. Home Page

Hero section with property search and featured listings

2. Property Listing

Browse all properties with filters

3. Property Details

Detailed view with image gallery, seller info, and contact options

4. Seller & Company Dashboards

Manage your property listings

Manage relocation requests (Packers & Movers)

5. Packers & Movers

Book relocation services

6. Real-time Chat

Chat with property owners or service providers

7. Payment Flow

Razorpay payment integration

8. Dark & Light Mode

Dark Theme

Light Theme

9. Mobile View

Fully responsive mobile experience

---

🛠️ Tech Stack

Frontend

Technology	Purpose
React 19	UI Framework
React Router 7	Navigation
Axios	API Calls
TailwindCSS	Styling
React Icons	Icons
React Toastify	Notifications
Firebase	Google Auth
Vercel	Hosting

Backend

Technology	Purpose
Django 6	Web Framework
Django REST Framework	REST API
Django Channels	WebSocket (Chat)
Simple JWT	Authentication
Cloudinary	Image Storage
PostgreSQL	Database
Brevo (Sendinblue)	Email Service
Razorpay	Payments
Render	Hosting

---

📦 Installation

Prerequisites

• Node.js 18+
• Python 3.10+
• PostgreSQL (or use SQLite for development)

Frontend Setup

cd frontend
npm install
npm start

Backend Setup

cd backend
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt
python manage.py migrate
python manage.py runserver

Environment Variables

Create .env files in both frontend and backend directories:

Backend .env:

SECRET_KEY=your-django-secret-key
DEBUG=False
DATABASE_URL=your-postgresql-url
CLOUDINARY_CLOUD_NAME=your-cloud-name
CLOUDINARY_API_KEY=your-api-key
CLOUDINARY_API_SECRET=your-api-secret
BREVO_API_KEY=your-brevo-key
RAZORPAY_KEY_ID=your-razorpay-key
RAZORPAY_KEY_SECRET=your-razorpay-secret

---

📂 Project Structure

UrbanShift/
├── frontend/                 # React Frontend
│   ├── public/
│   │   ├── urbanshift-logo.png
│   │   └── manifest.json
│   └── src/
│       ├── components/       # UI Components
│       ├── context/          # Theme Context
│       └── App.js
│
├── backend/                  # Django Backend
│   ├── backend/              # Settings & URLs
│   ├── users/                # User Auth & Profiles
│   ├── properties/           # Property CRUD
│   ├── relocation/           # Packers & Movers
│   ├── chat/                 # WebSocket Chat
│   ├── payments/             # Razorpay Integration
│   └── requirements.txt
│
└── README.md

---

👨‍💻 Author

Shubham Singh

• GitHub: @shubbhamsingh
• LinkedIn: Shubham Raj

---

📄 License

This project is licensed under the MIT License.

---

Made with ❤️ in India 🇮🇳