Contributing & support

All OI Laravel packages are open source, actively maintained, and welcome contributions.

Where the code lives

Every package is a standalone repository under the oi-lab organization on GitHub, and is published on Packagist under the oi-lab vendor. Each repository ships the same tooling — a Pest test suite, a Pint config, a CI matrix, and a CHANGELOG — so the development setup is identical from one package to the next.

Reporting issues

Found a bug or have an idea? Open an issue on the relevant package's GitHub repository (github.com/oi-lab/oi-laravel-<slug>). A clear reproduction and the package/PHP/Laravel versions you're running go a long way.

Contributing changes

1. Fork the package repository and create a branch.

2. Make your change, following the shared conventions.

3. Add or update tests, then run the suite and the formatter:

   bash

   composer test   # vendor/bin/pest
   composer lint   # vendor/bin/pint

4. If you changed the package's behaviour, update its AI skill stub so the assistant context stays accurate (see Skills & AI).

5. Open a pull request against main.

CI runs the full PHP 8.2/8.3/8.4 × Laravel 11/12/13 matrix on every pull request.

License

All OI Laravel packages are released under the MIT License — one of the most permissive open-source licenses available.

MIT License

Copyright (c) oi-lab

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

What this means

Under the MIT License, you are free to use the packages in personal and commercial projects, modify the source, distribute copies or modified versions, and sublicense within your own products. The only requirement is that the original copyright notice and license text are included in any substantial copy or distribution.

There are no paid tiers, license keys, or usage restrictions — every package is installable via Composer at no cost.