Genealogy is a free and open-source (family tree) application to record family members and their relationships, build with PHP (Laravel 11).
Genealogy is a free and open-source (family tree) application to record family members and their relationships, build with PHP (Laravel 11).
This application is build using :
A person can have 1 biological father (1 person, based on father_id)
A person can have 1 biological mother (1 person, based on mother_id)
A person can have 1 set of parents, biological or not (1 couple of 2 people, based on parents_id)
A person can have 0 to many biological children (n people, based on father_id/mother_id)
A person can have 0 to many partners (n people), being part of 0 to many couples (opposite or same biological sex)
A person can be part of a couple with the same partner multiple times (remarriage or reunite)
A couple can have 0 to many children (based on parents_id as a couple or father_id/mother_id individually)
A couple can be married or not, still together or separated in the meantime
This project is open-sourced software licensed under the MIT license.
This demo has 2 family trees implemented, BRITISH ROYALS and KENNEDY.
Password | Purpose | |
---|---|---|
[email protected] | password | to view teams BRITISH ROYALS and KENNEDY as team owner |
[email protected] | password | to view team BRITISH ROYALS as manager |
[email protected] | password | to view team KENNEDY as editor |
[email protected] | password | to view team BRITISH ROYALS as normal member |
[email protected] | password | to view team KENNEDY as normal member |
[email protected] | password | to view options reserved for the developer, like the user management and access to all persons in all teams |
This application has a built-in Backup Manager :
This application has a built-in Log Viewer showing :
This application has a built-in User management & logging, available to the developer :
Both the ancestors and descendants family trees are build using Recursive Common Table Expressions (Recursive CTE). This prevents the N+1 query problem generating the recursive tree family elements and dramatically improves performance.
create a new project folder, cd into the folder
git clone https://github.com/MGeurts/genealogy.git .
cp .env.example .env
make the needed changes regarding name, url, database connection & mail server
composer install
php artisan key:generate
php artisan storage:link
php artisan migrate:fresh --seed
npm install & npm run build
php artisan serve
or npm run dev
cp env.docker .env
run following command to initialize project
docker run --rm \
-u "$(id -u):$(id -g)" \
-v "$(pwd):/var/www/html" \
-w /var/www/html \
laravelsail/php83-composer:latest \
composer install --ignore-platform-reqs
run docker containers
./vendor/bin/sail up -d
./vendor/bin/sail artisan key:generate
./vendor/bin/sail artisan storage:link
./vendor/bin/sail artisan migrate:fresh --seed
./vendor/bin/sail npm install & npm run build
./vendor/bin/sail artisan serve
or npm run dev
php artisan test
Feel free to submit Issues or Pull Requests, for bugs, suggestions or feature requests.
The documentation is built-in the applications help. Visit the demo project to read the documentation.
If you like this project, please consider giving it a star and spread the word. Thank you.
This application is based on an original idea by Nafies Luthfi. Thanks for your excellent work.
This Laravel application is designed and developed by kreaweb.be.