Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add instructions for building Dockerfile and the laravel sail compose one at the file README.MD #734

Closed
curtisdelicata opened this issue Jun 7, 2024 · 1 comment · Fixed by #770
Labels

Comments

@curtisdelicata
Copy link
Contributor

curtisdelicata commented Jun 7, 2024

No description provided.

Copy link
Contributor

sweep-ai bot commented Jun 8, 2024

🚀 Here's the PR! #771

💎 Sweep Pro: You have unlimited Sweep issues

Actions

  • ↻ Restart Sweep

Step 1: 🔎 Searching

(Click to expand) Here are the code search results. I'm now analyzing these search results to write the PR.

# Liberu Genealogy
![](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/JavaScript-ECMA2020-informational?style=flat&logo=JavaScript&color=F7DF1E)
![](https://img.shields.io/badge/Livewire-3.5-informational?style=flat&logo=Livewire&color=fb70a9)
![](https://img.shields.io/badge/Filament-3.2-informational?style=flat&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI0OCIgaGVpZ2h0PSI0OCIgeG1sbnM6dj0iaHR0cHM6Ly92ZWN0YS5pby9uYW5vIj48cGF0aCBkPSJNMCAwaDQ4djQ4SDBWMHoiIGZpbGw9IiNmNGIyNWUiLz48cGF0aCBkPSJNMjggN2wtMSA2LTMuNDM3LjgxM0wyMCAxNWwtMSAzaDZ2NWgtN2wtMyAxOEg4Yy41MTUtNS44NTMgMS40NTQtMTEuMzMgMy0xN0g4di01bDUtMSAuMjUtMy4yNUMxNCAxMSAxNCAxMSAxNS40MzggOC41NjMgMTkuNDI5IDYuMTI4IDIzLjQ0MiA2LjY4NyAyOCA3eiIgZmlsbD0iIzI4MjQxZSIvPjxwYXRoIGQ9Ik0zMCAxOGg0YzIuMjMzIDUuMzM0IDIuMjMzIDUuMzM0IDEuMTI1IDguNUwzNCAyOWMtLjE2OCAzLjIwOS0uMTY4IDMuMjA5IDAgNmwtMiAxIDEgM2gtNXYyaC0yYy44NzUtNy42MjUuODc1LTcuNjI1IDItMTFoMnYtMmgtMnYtMmwyLTF2LTQtM3oiIGZpbGw9IiMyYTIwMTIiLz48cGF0aCBkPSJNMzUuNTYzIDYuODEzQzM4IDcgMzggNyAzOSA4Yy4xODggMi40MzguMTg4IDIuNDM4IDAgNWwtMiAyYy0yLjYyNS0uMzc1LTIuNjI1LS4zNzUtNS0xLS42MjUtMi4zNzUtLjYyNS0yLjM3NS0xLTUgMi0yIDItMiA0LjU2My0yLjE4N3oiIGZpbGw9IiM0MDM5MzEiLz48cGF0aCBkPSJNMzAgMThoNGMyLjA1NSA1LjMxOSAyLjA1NSA1LjMxOSAxLjgxMyA4LjMxM0wzNSAyOGwtMyAxdi0ybC00IDF2LTJsMi0xdi00LTN6IiBmaWxsPSIjMzEyODFlIi8+PHBhdGggZD0iTTI5IDI3aDN2MmgydjJoLTJ2MmwtNC0xdi0yaDJsLTEtM3oiIGZpbGw9IiMxNTEzMTAiLz48cGF0aCBkPSJNMzAgMThoNHYzaC0ydjJsLTMgMSAxLTZ6IiBmaWxsPSIjNjA0YjMyIi8+PC9zdmc+&&color=fdae4b&link=https://filamentphp.com)
![Latest Stable Version](https://img.shields.io/github/release/liberu-genealogy/genealogy-laravel.svg)
[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/laravel-liberu/genealogy/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/laravel-liberu/genealogy/?branch=master)
[![Code Intelligence Status](https://scrutinizer-ci.com/g/laravel-liberu/genealogy/badges/code-intelligence.svg?b=master)](https://scrutinizer-ci.com/code-intelligence)
[![StyleCI](https://github.styleci.io/repos/752324280/shield?branch=main)](https://github.styleci.io/repos/752324280?branch=main)
[![CodeFactor](https://www.codefactor.io/repository/github/familytree365/genealogy/badge/master)](https://www.codefactor.io/repository/github/familytree365/genealogy/overview/master)
[![codebeat badge](https://codebeat.co/badges/911f9e33-212a-4dfa-a860-751cdbbacff7)](https://codebeat.co/projects/github-com-modulargenealogy-genealogy-master)
[![Codacy Badge](https://app.codacy.com/project/badge/Grade/42a5f379686b4e9ebcfed6ddaa853185)](https://app.codacy.com/gh/liberu-genealogy/genealogy-laravel/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)
[![Install](https://github.com/liberu-genealogy/genealogy-laravel/actions/workflows/install.yml/badge.svg)](https://github.com/liberu-genealogy/genealogy-laravel/actions/workflows/install.yml)
[![Tests](https://github.com/liberu-genealogy/genealogy-laravel/actions/workflows/tests.yml/badge.svg)](https://github.com/liberu-genealogy/genealogy-laravel/actions/workflows/tests.yml)
### Other active projects
* https://github.com/liberu-accounting/accounting-laravel
* https://github.com/liberu-automation/automation-laravel
* https://github.com/liberu-cms/cms-laravel
* https://github.com/liberu-crm/crm-laravel
* https://github.com/liberu-ecommerce/ecommerce-laravel
* https://github.com/liberu-maintenance/maintenance-laravel
* https://github.com/liberu-real-estate/real-estate-laravel
## 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.
### Description
Liberu Genealogy, now fully compatible with PHP 8.3 and Laravel 11, is an innovative open-source project that continues to revolutionize genealogical research and family history exploration. With the latest update, we've introduced new features and significant improvements, ensuring a more robust and efficient platform for our users. This update not only enhances performance but also brings new functionalities that leverage the full potential of PHP 8.3 and Laravel 11, providing a cutting-edge platform to discover and preserve ancestral heritage.
Our project is based on a sophisticated genealogy website built on Laravel 11, providing users with a smooth and intuitive experience as they explore their family history. By leveraging Laravel's elegant syntax and comprehensive range of tools, we have developed a comprehensive application that allows users to easily create, manage, and explore their family trees.
Furthermore, our project, being open source, fosters collaboration and innovation within the genealogy community. Developers can leverage the technologies used to enhance the functionalities of Liberu Genealogy, propose improvements, and tailor the platform to their specific needs. We actively encourage a vibrant community of developers who utilize our open-source code to develop complementary tools and applications, thus creating an environment conducive to continuous improvement and expansion.
Establishing your own family tree has never been easier. Our platform offers two convenient options to get started. You can import data in various standard formats or manually enter the information yourself.
In order to ensure seamless integration with existing databases and records of family trees, we provide robust API support. Our API facilitates effortless import and export of Gedcom data and DNA matching results. Additionally, we are constantly innovating and will soon introduce Smart Matching, enabling easy connection with resources on other servers, thus expanding your research possibilities.
The security and confidentiality of your data are our top priorities. Your information is securely stored on our server and will never be shared without your explicit authorization. We understand the sensitivity of personal data, and we are committed to protecting your privacy.
On our platform you will find user-friendly data tables that provide comprehensive support for CRUD operations. This allows you to easily manage your family tree information. Whether you need to create, read, update or delete data entries, our intuitive interface ensures a seamless experience.
Customization is crucial, and our forms are designed to be easily editable to meet your specific needs. Customize your family tree to reflect the unique nuances and details of your lineage. Our flexible forms allow you to capture the rich history and connections that make your family history truly special.
To get started, install the application available at https://github.com/liberu-genealogy/genealogy-laravel.
Download it and explore its user-friendly interface, unleashing the power to easily create and discover your family's legacy.
Download our software today and embark on an enriching journey of tracing your roots and discovering the stories that connect generations.
## Contributors
<a href = "https://github.com/liberu-genealogy/genealogy-laravel/graphs/contributors">
<img src = "https://contrib.rocks/image?repo=liberu-genealogy/genealogy-laravel"/>

{
"name": "liberu-genealogy/genealogy-laravel",
"type": "project",
"description": "The Genealogy Laravel Framework.",
"keywords": ["framework", "laravel"],
"license": "MIT",
"require": {
"php": "^8.3",
"filament/filament": "^3.2-stable",
"althinect/filament-spatie-roles-permissions" :"^2.2",
"guzzlehttp/guzzle": "^7.8",
"laravel/framework": "^11.0",
"laravel/jetstream": "*",
"laravel/octane": "^2.3",
"laravel/sanctum": "^4.0",
"laravel/tinker": "^2.9",
"liberu-genealogy/laravel-dna": "^1.0",
"liberu-genealogy/laravel-gedcom": "^4.1",
"livewire/livewire": "^3.5"
},
"require-dev": {
"fakerphp/faker": "^1.23",
"laravel/pint": "^1.14",
"laravel/sail": "^1.28",
"mockery/mockery": "^1.6",
"nunomaduro/collision": "^8.0",
"phpunit/phpunit": "^11.0",
"spatie/laravel-ignition": "^2.4"
},
"autoload": {
"psr-4": {
"App\\": "app/",
"Database\\Factories\\": "database/factories/",
"Database\\Seeders\\": "database/seeders/"
}
},
"autoload-dev": {
"psr-4": {
"Tests\\": "tests/"
}
},
"scripts": {
"post-autoload-dump": [
"Illuminate\\Foundation\\ComposerScripts::postAutoloadDump",
"@php artisan package:discover --ansi",
"@php artisan filament:upgrade"
],
"post-update-cmd": [
"@php artisan vendor:publish --tag=laravel-assets --ansi --force"
],
"post-root-package-install": [
"@php -r \"file_exists('.env') || copy('.env.example', '.env');\""
],
"post-create-project-cmd": [
"@php artisan key:generate --ansi"
]
},
"extra": {
"branch-alias": {
"dev-master": "10.x-dev"
},
"laravel": {
"dont-discover": []
}
},
"config": {
"optimize-autoloader": true,
"preferred-install": "dist",
"sort-packages": true,
"allow-plugins": {
"pestphp/pest-plugin": true
}
},
"minimum-stability": "dev",
"prefer-stable": true

Step 2: ⌨️ Coding

I'm going to follow the following steps to help you solve the GitHub issue:

  1. Add instructions for building the Dockerfile to the README.md file.
  2. Add instructions for using the Laravel Sail compose file to the README.md file.

Here are the changes we decided to make. I'm done making edits and now I'm just validating the changes using a linter to catch any mistakes like syntax errors or undefined variables:

README.md

1. Add instructions for building the Dockerfile to the README.md file.
--- 
+++ 
@@ -16,6 +16,21 @@
 
 Customization is crucial, and our forms are designed to be easily editable to meet your specific needs. Customize your family tree to reflect the unique nuances and details of your lineage. Our flexible forms allow you to capture the rich history and connections that make your family history truly special.
 
+## Building the Dockerfile
+
+To build the Dockerfile and create a Docker image for the project, follow these steps:
+
+1. Open a terminal and navigate to the project directory.
+2. Run the following command to build the Docker image:
+   ```
+   docker build -t genealogy-laravel .
+   ```
+3. Once the build process is complete, you can run the Docker container using the following command:
+   ```
+   docker run -p 8000:8000 genealogy-laravel
+   ```
+4. Access the application in your web browser at `http://localhost:8000`.
+
 To get started, install the application available at https://github.com/liberu-genealogy/genealogy-laravel.
 
 Download it and explore its user-friendly interface, unleashing the power to easily create and discover your family's legacy.

README.md

2. Add instructions for using the Laravel Sail compose file to the README.md file.
--- 
+++ 
@@ -13,6 +13,21 @@
    ```
 4. Access the application in your web browser at `http://localhost:8000`.
 
+## Using Laravel Sail
+
+Laravel Sail provides a convenient way to run the project using Docker containers. To use Laravel Sail, follow these steps:
+
+1. Make sure you have Docker installed on your system.
+2. Open a terminal and navigate to the project directory.
+3. Run the following command to start the Laravel Sail containers:
+   ```
+   ./vendor/bin/sail up
+   ```
+4. Once the containers are up and running, you can access the application in your web browser at `http://localhost`.
+5. To stop the containers, press `Ctrl+C` in the terminal.
+
+For more information on using Laravel Sail, refer to the official documentation: [Laravel Sail Documentation](https://laravel.com/docs/sail)
+
 To get started, install the application available at https://github.com/liberu-genealogy/genealogy-laravel.
 
 Download it and explore its user-friendly interface, unleashing the power to easily create and discover your family's legacy.

Step 3: 🔄️ Validating

Your changes have been successfully made to the branch sweep/add_instructions_for_building_dockerfile_d6c42. I have validated these changes using a syntax checker and a linter.


Tip

To recreate the pull request, edit the issue title or description.

This is an automated message generated by Sweep AI.

@curtisdelicata curtisdelicata changed the title Improve docker image and add instructions for our custom and also the previously default sail compose one Refactor and upgrade node in docker image located at Dockerfile and add instructions for building Dockerfile and also the previously laravel sail compose one Jun 8, 2024
@curtisdelicata curtisdelicata changed the title Refactor and upgrade node in docker image located at Dockerfile and add instructions for building Dockerfile and also the previously laravel sail compose one Refactor and upgrade node in docker image located at Dockerfile and add instructions for building Dockerfile and also the previously laravel sail compose one at the file README.MD Jun 8, 2024
@curtisdelicata curtisdelicata changed the title Refactor and upgrade node in docker image located at Dockerfile and add instructions for building Dockerfile and also the previously laravel sail compose one at the file README.MD add instructions for building Dockerfile and the prevy laravel sail compose one at the file README.MD Jun 8, 2024
@curtisdelicata curtisdelicata changed the title add instructions for building Dockerfile and the prevy laravel sail compose one at the file README.MD add instructions for building Dockerfile and the laravel sail compose one at the file README.MD Jun 8, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
1 participant