Thank you for considering contributing to Warden! We welcome contributions from the community to help make this package better.
This project and everyone participating in it is governed by our Code of Conduct. By participating, you are expected to uphold this code.
Before creating bug reports, please check the existing issues to avoid duplicates. When you create a bug report, include as many details as possible:
- A clear and descriptive title
- Detailed steps to reproduce the issue
- The expected behavior
- The actual behavior
- Your environment details (PHP version, Laravel version, etc.)
If you have ideas for new features or improvements:
- Use a clear and descriptive title
- Provide a detailed description of the proposed feature
- Explain why this enhancement would be useful
- Consider how it might impact existing users
- Fork the repository
- Create a new branch (
git checkout -b feature/amazing-feature) - Make your changes
- Run the tests if applicable
- Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Warden targets PHP 8.3–8.5 and Laravel 12–13. New behavior must work across that declared compatibility matrix.
- Follow the existing code style and conventions
- Update documentation as needed
- Add tests for new features
- Ensure
composer test,composer phpstan,composer rector, andcomposer validate --strictpass - Preserve the documented exit-code and machine-report contracts
- Use stable finding IDs and include remediation for every new rule
- Keep pull requests focused - one feature/fix per PR