Skip to content
Laravel Zero — home
Contributing

Documentation

Contributing

How to contribute to Laravel Zero

On this page

Introduction#

Everything we make is 100% open source and developed collaboratively by people from all over the world. Even if you're not a programmer, you can get involved and make a difference — improving the documentation, reporting a bug, or helping someone in an issue thread all count.

Bug Reports#

To encourage active collaboration, we strongly encourage pull requests, not just bug reports. Bug reports may also be sent in the form of a pull request containing a failing test.

However, if you file a bug report, your issue should contain a title and a clear description of the issue. You should also include as much relevant information as possible, and a code sample that demonstrates the problem. The goal of a bug report is to make it easy for yourself — and others — to reproduce the bug and develop a fix.

Feature Requests#

You may propose new features or improvements to existing Laravel Zero behavior. If you propose a new feature, please be willing to implement at least some of the code that would be needed to complete it.

Remember that Laravel Zero is deliberately minimal. A feature that only a handful of applications need is often better served by a separate package than by the framework itself.

Which Repository?#

Laravel Zero's source code is managed on GitHub, and is split across a number of repositories:

Repository Description
laravel-zero/laravel-zero The application skeleton created by composer create-project.
laravel-zero/framework The framework itself, including all of its components.
laravel-zero/docs This documentation.
laravel-zero/laravel-zero.com The Laravel Zero website.
nunomaduro/collision The error reporting used by every application.

The full contribution guidelines are available within the CONTRIBUTING.md file, and the CHANGELOG contains detailed information about every release.

Security Vulnerabilities#

Please don't disclose security-related issues publicly. If you discover a security vulnerability within Laravel Zero, report it privately using one of the following channels:

  1. GitHub private vulnerability reporting (preferred) — visit the Security tab of the framework repository and click "Report a vulnerability".
  2. Email — send the details to Nuno Maduro at enunomaduro@gmail.com.

All security vulnerabilities will be promptly addressed.

Funding#

Laravel Zero, Collision, and the rest of Nuno Maduro's work have always been released under the MIT license, and will continue to be into the far future. It has cost thousands of hours to develop, test, and support them.

If you find this work valuable, you can show your appreciation by supporting it. The support is used to create new features and to make console development as enjoyable as possible:

License#

Laravel Zero is open-sourced software licensed under the MIT license.

Spotted a mistake? Edit this page on GitHub.