PropView — Property Platform

A Malaysian property listing and search platform built with React, FastAPI, and Ollama-powered AI chatbot.

Prerequisites

Tool	Version	Purpose
Node.js	18+	Frontend runtime
npm	9+	Package manager
Python	3.10+	Backend API
pip	latest	Python packages
Ollama	latest	AI chatbot (optional)

Quick Start

1. Clone the repository

git clone https://github.com/Jhaur/Property-Platform.git
cd Property-Platform

2. Start the Frontend

cd frontend
npm install
npm run dev

The frontend runs at http://localhost:5173

3. Start the Backend API

Open a new terminal:

cd backend
pip install fastapi uvicorn httpx
uvicorn server:app --reload --port 8000

The API runs at http://localhost:8000

4. Start Ollama Chatbot (Optional)

The chatbot works in fallback mode (quick replies) without Ollama. To enable AI-powered responses:

# Install Ollama from https://ollama.com
ollama serve

In another terminal, pull the model:

ollama pull llama3.2:3b

Ollama runs at http://localhost:11434

Demo Accounts

Role	Email	Password
Admin	admin@propview.my	admin123
Agent	benson@propview.my	agent123
Buyer	buyer@propview.my	buyer123

Project Structure

Property-Platform/
├── frontend/          # React + Vite + Tailwind CSS
│   ├── src/
│   │   ├── components/   # Reusable UI components
│   │   ├── pages/        # Route pages
│   │   ├── share/        # Context providers, API helpers
│   │   └── data/         # Mock data
│   └── public/
├── backend/           # FastAPI server
│   ├── server.py         # API endpoints
│   └── share/
│       └── prompts.py    # Role-based chatbot prompts
├── storage/           # Property images
└── database/          # Database docs (future)

Tech Stack

• Frontend: React 19, Vite, Tailwind CSS, Framer Motion, Leaflet (maps)
• Backend: FastAPI, Uvicorn
• AI Chatbot: Ollama with llama3.2:3b model
• Maps: Leaflet + OpenStreetMap (free, no API key needed)

Running All Services

Open 3 terminal windows:

# Terminal 1 — Frontend
cd frontend && npm run dev

# Terminal 2 — Backend API
cd backend && uvicorn server:app --reload --port 8000

# Terminal 3 — Ollama (optional)
ollama serve

Then open http://localhost:5173 in your browser.