Contributing

🤝 Contributing to Laravel Crypto

We welcome contributions to the Laravel Crypto package! Whether you're fixing a bug, adding a feature, or improving the documentation, your contributions are highly valued.

Steps to Contribute

  1. Fork the Repository
    First, fork the repository on GitHub. This will allow you to make changes and submit a pull request.

  2. Clone Your Fork
    Clone the repository to your local machine:

    git clone https://github.com/your-username/laravel-crypto.git

  3. Create a Branch Create a new branch for your changes:

    git checkout -b feature/your-feature-name

  4. Make Your Changes

Make the necessary changes in the codebase. If you’re fixing a bug or adding a feature, please ensure that your code adheres to the coding standards and passes existing tests.

  1. Run Tests

If you’re adding new functionality or fixing an issue, please write tests to verify that your changes work as expected. This ensures the stability and reliability of the package.

  1. Run Tests Before submitting your pull request, run the tests to make sure everything works properly:
./vendor/bin/pest
  1. Commit Your Changes

Once you’ve made your changes, commit them to your branch:

git add .
git commit -m "feat: add your commit message here"
  1. Push Changes

Push your changes to your fork on GitHub:

git push origin feature/your-feature-name
  1. Create a Pull Request

Go to your GitHub fork, click on the Pull Request tab, and submit a pull request. Make sure to describe your changes in detail, explaining what problem your changes solve or what feature you’ve added.

🧪 Testing Laravel Crypto Locally

To test the Laravel Crypto package locally on your system, follow the steps below:

  1. Clone the Repository

If you haven’t already, clone the repository to your local machine:

git clone https://github.com/akira-io/laravel-crypto.git
  1. Install Dependencies

Navigate to the project directory and install the required dependencies using Composer:

cd laravel-crypto
composer install
  1. Set Up Your Laravel Application
  • Set up your Laravel application by creating a .env file and generating an application key:
cp .env.example .env
php artisan key:generate
  • Add the Laravel Crypto package to your Laravel app by requiring it via Composer:
composer require akira/laravel-crypto
  • Publish the configuration file for the Laravel Crypto package:
php artisan vendor:publish --tag=crypto-config
  • Generate an encryption key for secure data encryption:
php artisan crypto:generate-key

💡 Helpful Resources

Encrypt Data