README

The open-source real estate platform that empowers agents, landlords and developers — built on Laravel 13, PHP 8.5, Filament 5 and Livewire 4.

About

Liberu Real Estate is a fully featured, open-source property management and estate agency platform. It brings together property listings, tenant management, bookings, bids, neighbourhood insights, and cutting-edge AI/VR tools in a single, modular Laravel application. Whether you're running a solo letting agency or building a multi-branch operation, Liberu Real Estate gives you a production-ready foundation you can extend and deploy with confidence.

• 🏠 Manage properties, tenants, landlords, bookings and transactions in one place
• 🤖 AI-powered valuations and smart-contract rental agreements
• 🌐 Live demo at agent.liberu.co.uk
• 🛠️ Fully open-source — fork it, extend it, ship it

Features

Installation

Prerequisites

• PHP 8.5+
• Composer 2
• MySQL 8 / PostgreSQL 15 / SQLite 3
• Node.js 20+ & npm (for front-end assets)

Option 1 — Command-line installer (setup.sh)

The quickest way to get started on Linux/macOS:

git clone https://github.com/liberu-real-estate/real-estate-laravel.git
cd real-estate-laravel
chmod +x setup.sh
./setup.sh

setup.sh copies .env.example → .env, generates the application key, installs Composer and npm dependencies, runs database migrations and seeds demo data automatically.

Option 2 — Graphical installer (install.php)

A browser-based graphical installer is included for shared-hosting and non-technical deployments:

1. Upload the project files to your web server.
2. Open https://your-domain.com/install.php in a browser.
3. Follow the step-by-step wizard to configure your database, environment and admin account.

Option 3 — Manual step-by-step

git clone https://github.com/liberu-real-estate/real-estate-laravel.git
cd real-estate-laravel
composer install
cp .env.example .env
php artisan key:generate
# Edit .env with your database credentials, then:
php artisan migrate --seed
npm install && npm run build
php artisan serve

Option 4 — Docker

docker build -t real-estate-laravel .
docker run -p 8000:8000 real-estate-laravel
# Or with Docker Compose:
docker compose up

Option 5 — Laravel Sail

./vendor/bin/sail up

Demo

Live demo: https://agent.liberu.co.uk

Documentation

• VR Property Design — Create and customise interiors in VR with 8 design styles and full furniture management
• Virtual Staging Tool — Upload and stage property images with AI-powered design styles
• Smart Contracts — Blockchain-based rental agreements with automated transactions
• Community Events Calendar — Display community events near properties on detail pages

Our Projects

The Liberu ecosystem contains a number of companion repositories and packages that extend or demonstrate functionality used in this boilerplate. Follow the links to learn more or to contribute.

Contributing

Contributions are warmly welcomed! Here's how to get involved:

1. Fork the repository and create a new branch from main (e.g. feature/my-new-feature).
2. Write tests for any new functionality or bug fix — we follow PHPUnit with the existing test suite.
3. Follow PSR-12 coding standards. Run ./vendor/bin/pint before committing to auto-fix style issues.
4. Open a Pull Request against main with a clear description of the change and why it's needed.
5. A maintainer will review your PR, leave feedback if necessary, and merge once approved.

For larger changes or new features, please open an issue first to discuss the approach before investing significant time. Bug reports, documentation improvements and translations are all equally valuable.

License

This project is licensed under the MIT License — see the LICENSE file for the full text.

What this means for you:

• ✅ Free to use — commercially and privately, without paying royalties.
• ✅ Free to modify — adapt the code to your exact business needs.
• ✅ Free to distribute — share your modifications or bundle the software in your own products.
• ✅ Free to sublicense — include it as part of a proprietary or SaaS offering.
• ℹ️ Attribution required — keep the copyright notice in any copy or substantial portion of the software.

The MIT license is one of the most permissive open-source licenses available. It gives you maximum freedom with minimal legal overhead, making it ideal for both personal projects and commercial deployments.

Maintainers

Project managed by Liberu — https://liberu.co.uk