🏠 Housespot

Your Future Home, Unlocked — Seamless House Hunting Platform Built with Django + Next.js

---

🚀 Project Overview

Housepot is a next-generation, full-stack house rental platform designed to transform how people search, discover, and rent homes across Kenya. Whether you're a tenant searching for your dream home or a landlord listing properties, Housepot makes the process smooth, smart, and secure.

---

🧠 Tech Stack

🖥 Frontend (Next.js + Tailwind)

• Next.js App Router
• TypeScript
• TailwindCSS + Framer Motion
• lucide-react for icons
• Fully responsive & optimized UI

🛠 Backend (Django + REST Framework)

• Django 5.x
• Django REST Framework
• JWT Authentication (SimpleJWT)
• Custom User Roles (Tenant & Landlord)
• CORS support & secure API integration

---

📂 Folder Structure

housespot/
│
├── backend/               # Django backend (API, models, auth)
├── frontend/              # Next.js frontend (pages, components, styles)
├── docs/                  # Project documentation
├── .env                   # Environment variables
└── README.md              # You're here 🚀

---

✨ Features

• 🔐 User Authentication (JWT) with custom user roles
• 🏠 Landlord Property Listing System
• 🔍 AI-enhanced Search & Smart Filters
• 🎥 High-quality listing visuals (Booked by Housepot Team)
• 📱 Fully Responsive Frontend UI
• 🧭 Explore by Location, Hero Search, App Teasers
• 📬 Newsletter Signups + CTA Integration
• ⚡ Framer Motion Animations

---

📸 Screenshots

Hero & Smart Search	Featured Listings	Dashboard

---

🔧 Installation & Setup

# Clone the repo
git clone https://github.com/your-username/housepot.git && cd housepot

# BACKEND SETUP
cd backend
python -m venv env
source env/Scripts/activate   # Use `source env/bin/activate` on Mac/Linux
pip install -r requirements.txt
python manage.py migrate
python manage.py runserver

# FRONTEND SETUP
cd ../frontend
npm install
npm run dev

---

🧪 API Testing

Use Postman or Thunder Client for:

• POST /api/users/register/
• POST /api/users/login/
• GET /api/listings/

---

📦 Deployment

• Frontend: Vercel
• Backend: Render, Railway, or Heroku
• Database: PostgreSQL / SQLite3 (Local)

---

👤 Author

Oliver Ambrose

💻 GitHub •
✉️ [email protected]

---

📄 License

Licensed under the MIT License.

💡 Built with love by Oliver | Designed to revolutionize rentals in Kenya 🇰🇪