1. Introduction

LuxeProperty is a complete, self-hosted real estate listing and property management platform built for agencies, brokerages, and independent developers who need a polished, buyer-facing platform that also runs the full operational workflow behind the scenes.

Unlike a basic listing script, LuxeProperty is a full property commerce platform: it handles the complete client journey from first browse through to booking, payment tracking, and verified review — with a dedicated portal for every actor in the system. Public buyers search and favourite properties, registered clients book viewings and track their payments, agents manage their listings and pipeline, and administrators control everything from branding to analytics from a single Admin Panel.

LuxeProperty is built in plain, dependency-light PHP and MySQL — no complex framework lock-in, no recurring SaaS fees, no per-seat licensing. A buyer owns the full source code outright and runs it on infrastructure they control.

2. Who This Is For

3. What Makes LuxeProperty Different

Most real estate listing scripts stop at "display properties, collect an enquiry." LuxeProperty goes substantially further:

4. Technology & Architecture

LuxeProperty deploys cleanly on ordinary shared hosting with cPanel, a VPS, or local development environments (XAMPP/WAMP/Laragon). The self-service installer handles the entire setup, including schema import, without requiring direct database or file-system access.

5. Modules — Detailed Breakdown

5.1 Public Website

• Responsive hero section with animated search card, Buy/Rent/Lease/Short Stay listing-type tabs, and a live featured listings panel drawn from the database
• Live stats bar on the hero — active listing count, client count, and agent count sourced from real DB queries, not hardcoded placeholders
• Full property listing page with inline meta chips (city, bedrooms, bathrooms, size with correct unit) and card-level favourite toggling
• Property detail page with full photo gallery, size/unit display, agent contact info, location details, amenities list, and verified buyer reviews
• Property search with keyword, city, type, listing type, bedroom count, and price-range filters
• Save/favourite properties for logged-in users, accessible via the Favourites page in their profile
• Agent profiles with bio, listings, ratings, and WhatsApp deep-link
• About, Contact, Privacy, Terms, and Sitemap pages managed via Admin CMS
• Fully theme-driven design — all colours, button styles, and accents update site-wide from a single Admin settings screen

Benefit: A complete, premium public storefront out of the box — no separate marketing site needs to be built. The hero, listings, and stats all reflect live data, so the site always looks current without manual updates.

5.2 User Accounts (Buyers & Renters)

• Self-service registration with profile management (name, phone, profile photo, password change)
• Personal dashboard showing active bookings, saved properties, recent messages, and notification feed
• Booking history with live status tracking (Pending / Confirmed / Completed / Cancelled)
• Payment history grouped by booking, with running balance and printable receipts
• Saved/favourited properties list with one-click removal
• Message inbox for direct agent communication
• Star-rated reviews gated to completed bookings only, held for admin moderation before publishing
• In-app notification centre with unread badge count
• Account deletion with password confirmation

Benefit: Buyers have a self-service portal that reduces agency support overhead — they can track their bookings, view payment history, and communicate with agents without calling the office.

5.3 Agent Portal

• Personal agent dashboard with listing count, active bookings, client messages, and performance summary
• Full property listing CRUD — create, edit, and manage listings with multi-photo upload, size and unit selection, amenity assignment, and rich specifications (bedrooms, bathrooms, size, listing type, year built, etc.)
• Listing type options: For Sale, For Rent, Lease, Short Stay — visible and filterable on the public site
• Booking management: view, confirm, complete, or cancel client viewing requests with automatic email notifications at each status change
• Payment recording workflow: record payments against bookings with method, date, reference, and notes; system tracks running balance and payment status automatically
• Client message inbox with reply threading
• Editable public agent profile with bio, designation, photo, social links, and WhatsApp number
• Amenity management: agents can propose custom amenities per listing (subject to admin approval)

Benefit: Agents get a dedicated workspace covering everything from listing creation to payment confirmation — without needing admin involvement in the day-to-day workflow.

5.4 Admin Panel

• Platform-wide dashboard with live KPIs: active listings, total bookings, total revenue, registered users, and agent count
• Full user management across all roles — create, edit, activate/deactivate, and assign agents to branches
• Admin property creation with agent assignment — create a listing directly from the Admin Panel and assign any registered agent to manage it from a searchable listbox
• Organisation management: Cities, Branches, and Property Types — each with its own default size unit
• Platform-wide property moderation: approve, reject, feature, edit, or remove any listing across all branches
• Booking oversight and payment confirmation across all agents and branches
• Review moderation queue — approve or reject buyer reviews before they appear publicly
• Analytics & Reports: booking trend charts, revenue by period, top agents by bookings and revenue, top properties by views, property type breakdown — exportable and printable
• System Settings across multiple tabs: Branding (logo, favicon, colours, theme variables), Company info, SMTP/email configuration, Google Maps API, listing defaults, and application environment
• CMS: manage About, Contact, Privacy, and Terms page content without code edits
• Activity log: full audit trail of platform actions filterable by user, action, and date

Benefit: Everything a platform operator needs to run, brand, and audit the business sits in one place — a non-technical administrator can fully operate the platform after initial setup, with no direct database or file-system access required for routine operations.

5.5 Booking & Payment Tracking

LuxeProperty does not process payments online. The payment module records how a client paid an agent directly, for bookkeeping and receipt purposes.

• Clients submit viewing/booking requests from the property detail page; agents confirm or decline with automatic email notification
• Agents record payments against confirmed bookings — full or instalment — with method, date, optional reference number, and notes
• Payment status (Unpaid / Partial / Paid) is derived live from recorded payments, so balances cannot silently drift out of sync
• Printable, branded payment receipts accessible by the client, the recording agent, and the admin
• Automatic email notification to the client when a payment is recorded
• Revenue dashboard with booking and payment totals, collected vs outstanding breakdown, and recent transaction list

Benefit: A practical bookkeeping layer suited to markets where property transactions close offline — every payment is recorded, every receipt is professional and printable, and both the agency and the client have a clear paper trail without needing a payment gateway integration.

If anyone wants gateway integration (Stripe, Flutterwave, Paystack, Paypal, etc.), please contact the Lakesoft Solutions support team — we will be glad to assist.

5.6 Property Size & Unit System

• Eight measurement units supported: Square Metres (m²), Square Feet (ft²), Acres, Hectares (ha), Square Yards (yd²), Guntha, Marla, Kanal
• Each property type carries a default size unit — Land defaults to Acres, all other types default to Square Metres — so the create form auto-selects the right unit when an agent picks a type
• The unit auto-switches via JavaScript when the property type dropdown changes, without a page reload
• Size displayed correctly throughout: property cards, detail pages, agent view, admin show, and search results all format size with the correct unit label
• Existing properties are back-filled with the correct unit at migration time

Benefit: A single platform can serve residential, commercial, and land listings without size data being meaningless or inconsistent — a 0.5-acre plot and a 120 m² apartment both display correctly in context.

5.7 Theme & Branding System

• All theme colours (primary, secondary, success, danger, warning, info, navbar background, footer background) are stored in the theme_settings database table and injected as CSS custom properties on every page load
• Live colour picker in Admin Settings with instant preview — change the entire site's colour scheme without touching a CSS file
• Bootstrap utility overrides are generated dynamically from the same variables — buttons, badges, and text colours all follow the admin-set palette automatically
• Logo and favicon uploaded directly from Admin → Brand Settings, stored in public/uploads/brand/ and served via BASE_URL-relative paths so they work correctly on any domain or subdomain
• Site name and tagline editable from Admin Settings — appear in the navbar, browser title, and hero section without code changes

Benefit: A developer can deploy LuxeProperty for a client, hand over Admin access, and the client can completely rebrand the platform — logo, colours, site name — without any further developer involvement.

5.8 Notifications & Messaging

• Transactional emails for key events: registration, welcome, booking confirmed/cancelled/completed, payment recorded, review submitted
• In-app notification centre per user role, with unread-count badge in the navigation
• Direct messaging between buyers and agents, with inbox/sent/thread view
• WhatsApp deep-link integration on agent profiles — one tap to open a WhatsApp conversation with the listing agent
• Social media links in the site footer (Facebook, Instagram, WhatsApp, LinkedIn, YouTube) — each appears only when configured, leaving no dead icons

Benefit: Every actor — buyer, agent, admin — is automatically kept informed at the right moments, and buyers can reach agents through their preferred channel (in-app message or WhatsApp) without leaving the platform.

6. Web Installer

LuxeProperty ships with a 5-step guided installation wizard accessible at /install/ after uploading files to the server.

Benefit: A developer or end customer can go from a blank hosting account to a fully running LuxeProperty installation in under 10 minutes, with no CLI access, no manual SQL import via phpMyAdmin, and no config file editing required.

7. Ownership, Customisation & Branding

LuxeProperty is sold as a complete, ownable codebase — there is no subscription, no per-seat fee, and no dependency on the seller's infrastructure after delivery. A buyer receives full source code and can:

• Re-brand entirely (name, logo, favicon, colours) via Admin Settings — no code edits required for standard rebranding
• Extend or modify any module, since the codebase uses plain, readable PHP with a simple custom MVC router and no proprietary framework abstractions to learn
• White-label the platform for deployment to real estate clients (subject to the specific licence terms agreed at sale)
• Run on infrastructure of their choosing — shared hosting, VPS, or dedicated server — with no seller-side dependency for continued operation
• Deploy on any subdirectory or subdomain — BASE_URL is written by the installer at setup time, so the platform works at domain.com/, domain.com/property/, or realestate.domain.com/ without code changes

8. Server Requirements

9. Summary

LuxeProperty is positioned as a complete property commerce platform — not just a listings website, but the system a real estate agency would actually run its client-facing and operational business on: buyers discovering and booking properties, agents managing their pipeline and recording payments, and administrators controlling the platform, branding, and analytics from a single Admin Panel.

Its self-hosted architecture, guided web installer, and admin-driven theme system make it deployable by a single developer in under an hour, while its depth — flexible size units, admin-created listings with agent assignment, verified reviews, booking-to-payment tracking, and a fully rebrandable frontend — gives it the substance to genuinely serve a real agency rather than just display a property grid.