1. Introduction

PropNest is a complete, self-hosted real estate listing and brokerage management platform built for property agencies, multi-branch real estate brands, and independent brokerages that need more than a basic listing website.

Unlike a typical "property listing theme," PropNest is a full operations platform: it doesn't stop at letting visitors browse listings — it runs the entire client journey from first enquiry through to a confirmed sale, including viewing bookings, agent-negotiated pricing, payment tracking with receipts, refunds, and branch-level performance reporting. It's the layer that sits between a public-facing property website and the internal tools a brokerage actually needs to run its day-to-day business.

PropNest 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 PropNest Different

Most real estate listing scripts on the market stop at "list a property, let people enquire." PropNest goes substantially further:

4. Technology & Architecture

PropNest deploys cleanly on ordinary shared hosting with cPanel, a VPS, or local development environments (XAMPP/WAMP/Laragon) — no containerisation, Node build pipeline, or specialised infrastructure required.

5. Modules — Detailed Breakdown

5.1 Public Website

• Responsive home page with configurable hero carousel (up to 5 slides), featured properties, city browser, and top-agent showcase
• Full property search: keyword, city, type, listing type (sale/rent), bedroom count, price-range filters
• Side-by-side property comparison tool
• Photo galleries with keyboard and swipe navigation
• Video Tour embed — YouTube URLs (watch or share format) automatically converted to embeddable iframes; agents paste any YouTube link, no manual embed code needed
• Virtual Tour embed — Matterport, Kuula, CloudPano, Eyespy360 and other 3D tour platforms rendered inline on property pages; Matterport auto-play parameters applied automatically; full-screen link provided alongside the iframe
• Interactive Google Maps on property detail pages, with graceful fallback to address text when GPS coordinates are not set
• Agent directory with public profiles, ratings, active listings, and Email Agent compose modal — server-side PHPMailer; Reply-To set to sender's address so agent replies go directly to the client's inbox
• Branch directory, public contact form with honeypot protection, save/favourite properties
• CMS static pages (About, Contact, Privacy Policy, Terms, Sitemap) — pre-seeded with ready-to-use content on fresh installation; editable via Summernote rich-text editor
• Four switchable visual themes: Modern, Classic, Minimal, Luxe
• AI chat assistant bubble — floating widget on all public pages powered by Google Gemini; live property database context injected per request; toggled on/off from System Settings

Benefit: A complete professional storefront including video and 3D virtual tours, AI-assisted property discovery, and direct agent communication — no separate marketing site required.

5.2 User Accounts (Clients/Buyers/Renters)

• Self-service registration with mandatory email verification
• 30-day Remember Me persistent login — secure rotating token cookie; works across all five roles
• Personal dashboard: bookings, enquiries, saved properties, notifications
• Booking history with live status tracking and cancellation
• Star-rated reviews gated to post-viewing completion, held for moderation
• Full payment history grouped by booking with running balance and branded printable receipts showing agency logo and name
• In-app notification centre, enquiry thread history, saved/favourited properties
• AI assistant available in the client dashboard — personalised experience; assistant is aware of the logged-in user's session context

Benefit: Clients get a self-service portal that reduces support overhead — they can track their own bookings, payments, and conversations without phoning the office, with AI-powered instant answers available at any hour.

5.3 Agent Portal

• Personal dashboard: listings, pending bookings, completed visits, open enquiries, monthly revenue
• Property listing CRUD with draft → approval workflow, multi-photo upload with AJAX single-image delete (remove individual photos without re-uploading others), amenity selection, and full spec fields
• Video Tour URL field — paste any YouTube URL; auto-converted to embed on the public listing page
• Virtual Tour URL field — paste a Matterport or similar 3D tour URL; rendered inline with VR/XR permissions
• Booking management: confirm, complete, cancel with automatic email notifications
• .ics calendar export, availability blocking calendar
• Enquiry inbox with reply threading, full payment recording workflow
• Editable public profile with bio, social links, WhatsApp, and performance stats

Benefit: Agents manage their full pipeline in one place, with 3D tour support giving clients an immersive pre-visit experience and AJAX image management reducing friction on listing updates.

5.4 Branch Manager Portal

• Branch-scoped dashboard, agent management, property approval queue, review moderation
• Branch-scoped payments view with confirmation and optional refund authority
• Branch performance reports with accurate Pending Payments count (bookings where confirmed payments fall short of agreed price), agent leaderboard (listings/bookings/rating/revenue), top properties by views — CSV export, printable

Benefit: A Branch Manager has real, enforced authority over their own branch's operations and finances — for multi-branch brokerages, this is the difference between a website and an actual management platform.

5.5 Admin Panel (Admin & Super Admin)

• Platform-wide dashboard, user management, organisation management (Cities, Branches, Amenities)
• Platform-wide property, bookings, payments, and reviews oversight
• CMS with rich-text editor, portable link handling, menu manager, and pre-seeded content pages
• Theme switcher, media library, activity log, system health diagnostic, roles & permissions
• Analytics & Reports with accurate Pending Payments KPI, trend charts, branch revenue, agent leaderboard, CSV export and print/PDF output
• System Settings across eleven tabs: Branding, Carousel, Homepage, Company, Maps, Email/SMTP (host, port, credentials, From address — fully configurable from the browser, no server file editing), Listings, Bookings, SEO, Security, and AI Assistant
• AI Assistant Settings tab: enable/disable toggle, API key (server-side only, masked), bot name, welcome message; free-tier and paid-tier guidance with Google pricing link provided inline

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

5.6 AI Assistant

PropNest includes a built-in AI chat assistant powered by Google Gemini, deployable platform-wide with a single toggle in System Settings.

• Floating chat bubble on all public pages and admin/agent dashboards when enabled
• Live property database context — the assistant automatically knows the current approved listings and can recommend specific properties in response to natural-language queries
• Role-aware responses — logged-in users receive a personalised experience; guests get property-discovery assistance
• All API calls are server-side — the Gemini API key is never sent to the browser or visible in page source
• Model fallback chain — automatically tries the next available Gemini model if the primary is unavailable
• Fully configurable from Admin Settings: enable/disable, API key, bot name, welcome message — no code deployment required
• Compatible with Google Gemini's free tier (testing and low-traffic use) and paid tiers (production); guidance and pricing link provided inline in the settings tab
• Graceful degradation — if the API is unavailable or not configured, the widget is hidden; no broken UI shown to visitors

Benefit: A 24/7 property assistant that knows the agency's actual live inventory — deployable in under five minutes with a free Google AI Studio API key, and switchable off instantly if needed.

5.7 Payments & Invoicing

Design philosophy: Real estate transactions in many markets are settled by cash, bank transfer, or other offline methods at a negotiated price. PropNest is built around this reality rather than forcing an online-checkout model that doesn't match how deals actually close.

• Agent-set Agreed Price per booking, independent of the public listing price
• Full and instalment payments, with balance-overflow prevention
• Payment method, date, reference number, and notes per payment record
• Automatic invoice numbering (INV-2026-00001 format, per year)
• Automatic email receipts and in-app notifications on payment recording
• Branded printable receipts — agency logo and name displayed prominently; client, agent, and admin all have access; clean print output without browser chrome
• Refunds with mandatory reason, sequential reference numbers, and full audit trail
• Payment status always derived live — balances can never silently drift out of sync
• Accurate pending-balance reporting in both Admin and Branch Manager dashboards

Benefit: A real bookkeeping layer for the brokerage's cash flow — every payment is auditable, every receipt is professional, and agents/managers/admins all see exactly the right slice of data for their role.

5.8 Roles & Permissions System

• Five built-in roles: User, Agent, Branch Manager, Admin, Super Admin
• 16-module permission matrix with per-action granularity; changes apply instantly platform-wide
• Sidebar navigation automatically hides inaccessible modules
• Branch-level data scoping enforced in code; cannot be accidentally widened via settings
• Super Admin permanently fully privileged — guaranteed recovery account

Benefit: Turns roles into genuinely configurable job functions — buyers tailor exactly what each role can do without code changes, and prove via the Activity Log who did what.

5.9 Notifications & Communications

• Branded transactional emails for every key event: verification, welcome, booking lifecycle, listing lifecycle, payments, refunds, password reset
• SMTP fully configurable from Admin Settings — host, port, credentials, encryption, From name and address; DB settings override .env; no server file editing for any mail change
• Email Agent modal on agent public profiles — compose and send via PHPMailer; Reply-To set to sender's address so agent replies land directly in the client's inbox
• In-app notification centre per role with unread-count badges
• WhatsApp deep-link integration on agent profiles and contact points
• Extended footer social icons: Facebook, Instagram, WhatsApp, LinkedIn, and YouTube — each appears only when configured, no dead icons
• Footer Credit Text — admin-configurable "Powered by …" credit; blank to hide completely, supporting white-label deployments

Benefit: Every actor is kept informed automatically. SMTP changes take effect immediately without redeployment. The Email Agent modal creates a direct professional communication channel between clients and agents.

7. Ownership, Customisation & Branding

PropNest is sold as a complete, ownable codebase — no subscription, no per-seat fee, no dependency on the seller's infrastructure after delivery:

• Re-brand entirely via System Settings (name, logo, colours, fonts, theme, footer credit text) — no code edits required
• Extend or modify any module — plain, readable PHP, no proprietary framework abstractions
• White-label for resale to multiple real estate clients (subject to licence terms agreed at sale)
• Configure AI independently per deployment — each instance uses its own Gemini API key, bot name, and on/off state
• Run on any infrastructure — shared hosting, VPS, or local development (XAMPP/WAMP/Laragon)

8.1 Payment Methods Supported

PropNest does not process payments online. The following methods record how a client physically paid an agent, for bookkeeping purposes:

Clients pay the agent directly (cash, bank transfer, etc.), and the agent records that payment so both parties have a receipt, running balance, and audit trail — both in the dashboard and by email.

If a payment gateway integration (Flutterwave, Paystack, Stripe, or PayPal) is required for a specific deployment, please contact the Lakesoft Solutions support team — we will be glad to help.

9. What's New in Version 1.1

10. Summary

PropNest is the operational backbone for a real estate brokerage — not just a listings website, but the system a multi-branch agency would actually run its business on: agents managing their pipeline, managers governing their branch, admins controlling the platform, and a complete, auditable payment and reporting layer underneath.

Version 1.1 extends the platform with AI-powered property discovery, immersive 3D virtual tour support, direct agent-to-client email communication, and a series of operational improvements — without increasing infrastructure complexity or introducing new mandatory dependencies.

Its self-hosted, dependency-light architecture and self-service installer make it deployable by a single developer in under an hour, while its depth — branch-scoped authority, configurable permissions, agent-negotiated payment tracking, AI assistant, and full CMS control — gives it the substance to genuinely replace the spreadsheets, WhatsApp groups, and disconnected tools many brokerages currently stitch together.