README

Welcome to Liberu, our visionary open-source initiative that marries the power of Laravel 12, PHP 8.5 and Filament 5.2 to redefine the landscape of web development.

A modern genealogy web application built with Laravel and Filament. This repository provides the application source, deployment tooling, and developer resources for running and contributing to Liberu Genealogy.

Key goals:

Provide a performant, extensible genealogy platform.
Support GEDCOM import/export and DNA-matching integrations.
Integrate with external genealogy services (MyHeritage, Ancestry, FamilySearch).
Offer a developer-friendly, modular codebase.
Support major genealogy platforms including FindMyPast, FamilySearch, Ancestry, and MyHeritage.

New Features:

FindMyPast Integration: Comprehensive support for FindMyPast record types including newspapers, parish records, census data, electoral registers, GRO indices, military records, probate records, and more. See FINDMYPAST_FEATURES.md for details.

Quick links: Demo • Hosting

Demo: https://familytree365.com
Managed hosting: https://liberu.co.uk

Quick start

Requirements: PHP 8.4, Composer, a database (MySQL / MariaDB / PostgreSQL), and optional Docker.

Clone the repository:

git clone https://github.com/liberu-genealogy/genealogy-laravel.git cd genealogy-laravel
Install and prepare (automated):

On Unix/macOS:
```
./setup.sh
```
Or run the manual steps:
```
composer install
cp .env.example .env
php artisan key:generate
php artisan migrate --seed
```
Notes:
- The setup script may offer to overwrite .env with .env.example. Choose carefully if you already have an .env file.
- Seeders will run during setup; skip them if you do not want sample data.

Docker

Build and run the included image (simple local test):

docker build -t genealogy-laravel .
docker run -p 8000:8000 genealogy-laravel

For development with containers, Laravel Sail or Docker Compose are recommended.

Laravel Sail

Start the Sail development environment:

./vendor/bin/sail up -d

Visit http://localhost once containers are ready.

Features

Smart Matching & Record Discovery

Liberu Genealogy integrates with major genealogy service providers to help you discover missing ancestors and fill gaps in your family tree:

MyHeritage Integration - Search MyHeritage family trees for potential matches
Ancestry Integration - Find records and family trees on Ancestry.com
FamilySearch Integration - Access the FamilySearch Family Tree
Intelligent Confidence Scoring - Machine learning-based matching algorithm
Automated Discovery - Background jobs continuously search for new matches
Match Management - Review, accept, or reject matches through intuitive UI

See docs/MYHERITAGE_INTEGRATION.md for setup instructions.

Core Genealogy Features

Family Tree Management - Build and visualize family trees with interactive charts
GEDCOM Support - Import and export standard GEDCOM files
DNA Matching - Upload DNA results and find genetic relatives
Smart Matching - Automatic discovery of potential ancestors
Media Management - Store photos, documents, and multimedia
Source Citations - Track and cite your genealogy sources
Research Tools - Checklists, notes, and collaboration features
Privacy Controls - Manage visibility of living persons

Our projects

The Liberu ecosystem contains a number of companion repositories and packages that extend or demonstrate functionality used in this boilerplate. Below is a concise, professional list of those projects with quick descriptions — follow the links to learn more or to contribute.

Project	Repository	Short description
Accounting	liberu-accounting/accounting-laravel	Accounting and invoicing features tailored for Laravel applications.
Automation	liberu-automation/automation-laravel	Automation tooling and workflow integrations for Laravel projects.
Billing	liberu-billing/billing-laravel	Subscription and billing management integrations (payments, invoices).
Boilerplate (core)	liberusoftware/boilerplate	Core starter and shared utilities used across Liberu projects.
Browser Game	liberu-browser-game/browser-game-laravel	Example Laravel-based browser game platform and mechanics.
CMS	liberu-cms/cms-laravel	Content management features and modular page administration.
Control Panel	liberu-control-panel/control-panel-laravel	Administration/control-panel components for managing services.
CRM	liberu-crm/crm-laravel	Customer relationship management features and integrations.
E‑commerce	liberu-ecommerce/ecommerce-laravel	E‑commerce storefront, product and order management.
Genealogy	liberu-genealogy/genealogy-laravel	Family tree and genealogy features built on Laravel.
Maintenance	liberu-maintenance/maintenance-laravel	Scheduling, tracking and reporting for maintenance tasks.
Real Estate	liberu-real-estate/real-estate-laravel	Property listings and real-estate management features.
Social Network	liberu-social-network/social-network-laravel	Social features, profiles, feeds and messaging for Laravel apps.

If you maintain or use one of these projects and would like a more detailed description or a different categorisation, open an issue or submit a pull request and we'll update the list. Contributions and cross-repo collaboration are warmly encouraged.

Contributing

Please read CONTRIBUTING.md and CODE_OF_CONDUCT.md before submitting pull requests. The project includes unit and feature tests—run them locally and ensure they pass.

Run tests:

vendor/bin/phpunit

License

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

Community & Support

Issues: https://github.com/liberu-genealogy/genealogy-laravel/issues
Discussions / feature requests are welcome via the repository.

Maintainers: Liberu Genealogy team

Contributors: see https://github.com/liberu-genealogy/genealogy-laravel/graphs/contributors

cgdprojects / genealogy

Maintainers

Details