# [Liberu Real Estate / Estate Agency](https://www.liberu.org.uk) ![Open Source Love](https://img.shields.io/badge/Open%20Source-%E2%9D%A4-red.svg)

![](https://img.shields.io/badge/PHP-8.3-informational?style=flat&logo=php&color=4f5b93)
![](https://img.shields.io/badge/Laravel-11-informational?style=flat&logo=laravel&color=ef3b2d)
![](https://img.shields.io/badge/Filament-3.2-informational?style=flat&logo=data:image/svg+xml;base64, &&color=fdae4b&link=https://filamentphp.com)
![Jetstream](https://img.shields.io/badge/Jetstream-5-purple.svg)
![Socialite](https://img.shields.io/badge/Socialite-latest-brightgreen.svg)
![](https://img.shields.io/badge/Livewire-3.5-informational?style=flat&logo=Livewire&color=fb70a9)
![](https://img.shields.io/badge/JavaScript-ECMA2020-informational?style=flat&logo=JavaScript&color=F7DF1E)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[![Install](https://github.com/liberu-real-estate/real-estate-laravel/actions/workflows/install.yml/badge.svg)](https://github.com/liberu-real-estate/real-estate-laravel/actions/workflows/install.yml)
[![Tests](https://github.com/liberu-real-estate/real-estate-laravel/actions/workflows/tests.yml/badge.svg)](https://github.com/liberu-real-estate/real-estate-laravel/actions/workflows/tests.yml)
[![Docker](https://github.com/liberu-real-estate/real-estate-laravel/actions/workflows/main.yml/badge.svg)](https://github.com/liberu-real-estate/real-estate-laravel/actions/workflows/main.yml)

## Description
Welcome to Liberu Real Estate/Estate Agency, our revolutionary open-source project that reshapes the real estate industry through the integration of Laravel 11, PHP 8.3, Livewire 3, and Filament 3. Liberu Real Estate is not just a software solution for property management; it's a dynamic platform designed to empower real estate professionals, property owners, and investors with innovative tools and seamless workflows.

## Our Projects

* https://github.com/liberu-accounting/accounting-laravel
* https://github.com/liberu-automation/automation-laravel
* https://github.com/liberu-billing/billing-laravel
* https://github.com/liberusoftware/boilerplate
* https://github.com/liberu-browser-game/browser-game-laravel
* https://github.com/liberu-cms/cms-laravel
* https://github.com/liberu-control-panel/control-panel-laravel
* https://github.com/liberu-crm/crm-laravel
* https://github.com/liberu-ecommerce/ecommerce-laravel
* https://github.com/liberu-genealogy/genealogy-laravel
* https://github.com/liberu-maintenance/maintenance-laravel
* https://github.com/liberu-real-estate/real-estate-laravel
* https://github.com/liberu-social-network/social-network-laravel

![](https://agent.liberu.co.uk/build/images/screenshot.png)

## Setup

1. Ensure your environment is set up with PHP 8.3 and Composer installed.
2. Download the project files from this GitHub repository.
3. Open a terminal in the project folder. If you are on Windows and have Git Bash installed, you can use it for the following steps.
4. Run the following command:

```bash
./setup.sh
```

and everything should be installed automatically if you are using Linux you just run the script as you normally run scripts in the terminal.

NOTE 1: The script will ask you if you want to have your .env be overwritten by .env.example, in case you have already an .env configuration available please answer with "n" (No).

NOTE 2: This script will run seeders, please make sure you are aware of this and don't run this script if you don't want this to happen.
```bash
composer install
php artisan key:generate
php artisan migrate --seed
```
This will install the necessary dependencies, generate an application key, and set up your database with initial data.

NOTE 3: Ensure your `.env` file is correctly configured with your database connection details before running migrations.

## Building with Docker

Alternatively, you can build and run the project using Docker. To build the Dockerfile, follow these steps:

1. Ensure you have Docker installed on your system.
2. Open a terminal in the project folder.
3. Run the following command to build the Docker image:
   ```
   docker build -t real-estate-laravel .
   ```
4. Once the image is built, you can run the container with:
   ```
   docker run -p 8000:8000 real-estate-laravel
   ```

NOTE 3: Ensure your `.env` file is correctly configured with your database connection details before running migrations.

### Using Laravel Sail

This project also includes support for Laravel Sail, which provides a Docker-based development environment. To use Laravel Sail, follow these steps:

1. Ensure you have Docker installed on your system.
2. Open a terminal in the project folder.
3. Run the following command to start the Laravel Sail environment:
   ```
   ./vendor/bin/sail up
   ```
4. Once the containers are running, you can access the application at `http://localhost`.
5. To stop the Sail environment, press `Ctrl+C` in the terminal.

For more information on using Laravel Sail, refer to the [official documentation](https://laravel.com/docs/sail).



**Key Features:**

1. **Intuitive Property Management:** Liberu Real Estate offers an intuitive and user-friendly platform for managing real estate properties. From listings and transactions to tenant relationships, our project simplifies the complexities of property management, ensuring a streamlined and efficient experience.

2. **Dynamic Livewire Interactions:** Built on Laravel 11 and PHP 8.3, Liberu Real Estate integrates Livewire 3 for dynamic and real-time interactions. Update property details, manage transactions, and communicate seamlessly with clients without the need for page refreshes.

3. **Efficient Admin Panel:** Filament 3, our admin panel built on Laravel, provides administrators with powerful tools to manage property listings, customize settings, and oversee the entire real estate ecosystem. Liberu Real Estate ensures that your real estate operations operate seamlessly, adapting to your organization's evolving needs.

4. **Transaction Tracking and Reporting:** Streamline transactions and stay informed with Liberu Real Estate's comprehensive tracking and reporting features. Monitor property sales, leases, and financial transactions, ensuring accurate and up-to-date financial records.

5. **Contractor Panel:** Provides contractors with a dedicated portal for managing their information, accessing resources, and more. This feature aims to streamline operations and enhance communication between contractors and property managers.

5. **Customizable Listings and Search:** Tailor property listings and search functionalities to match your real estate business's unique needs. Liberu Real Estate empowers users to create customizable listings and search parameters, ensuring a personalized and efficient property search experience.

Liberu Real Estate is open source, released under the permissive MIT license. We invite real estate professionals, developers, and property management teams to contribute to the evolution of real estate software. Together, let's redefine the standards of property management and create a platform that adapts to the unique needs of every real estate professional.

Welcome to Liberu Real Estate – where innovation meets efficiency, and the possibilities of real estate management are limitless. Join us on this journey to transform the way we buy, sell, and manage properties in the digital age.

<!--/h-->

### Licensed under MIT, use for any personal or commercial project.

## Demostration website
<!--/h-->

### Contributions

We warmly welcome new contributions from the community! We believe in the power of collaboration and appreciate any involvement you'd like to have in improving our project. Whether you prefer submitting pull requests with code enhancements or raising issues to help us identify areas of improvement, we value your participation.

If you have code changes or feature enhancements to propose, pull requests are a fantastic way to share your ideas with us. We encourage you to fork the project, make the necessary modifications, and submit a pull request for our review. Our team will diligently review your changes and work together with you to ensure the highest quality outcome.

However, we understand that not everyone is comfortable with submitting code directly. If you come across any issues or have suggestions for improvement, we greatly appreciate your input. By raising an issue, you provide valuable insights that help us identify and address potential problems or opportunities for growth.

Whether through pull requests or issues, your contributions play a vital role in making our project even better. We believe in fostering an inclusive and collaborative environment where everyone's ideas are valued and respected.

We look forward to your involvement, and together, we can create a vibrant and thriving project. Thank you for considering contributing to our community!
<!--/h-->

### License

This project is licensed under the MIT license, granting you the freedom to utilize it for both personal and commercial projects. The MIT license ensures that you have the flexibility to adapt, modify, and distribute the project as per your needs. Feel free to incorporate it into your own ventures, whether they are personal endeavors or part of a larger commercial undertaking. The permissive nature of the MIT license empowers you to leverage this project without any unnecessary restrictions. Enjoy the benefits of this open and accessible license as you embark on your creative and entrepreneurial pursuits.
<!--/h-->

## Contributors


<a href = "https://github.com/liberu-real-estate/real-estate-laravel/graphs/contributors">
  <img src = "https://contrib.rocks/image?repo=liberu-real-estate/real-estate-laravel"/>
