Contribution Guide #

Hi! I'm really excited that you are interested in contributing to Leaf. Before submitting your contribution, please make sure to take a moment and read through the following guidelines:

• Pull Request Guidelines
• Development Setup
• Project Structure

Pull Request Guidelines #

• The master branch is just a snapshot of the latest stable release. All development should be done in dedicated branches. Do not submit PRs against the master branch.

• Checkout a topic branch from the relevant branch, e.g. dev, and merge back against that branch.

• It's OK to have multiple small commits as you work on the PR - GitHub will automatically squash it before merging.

• If adding a new feature:

  • Add accompanying test case.
  • Provide a convincing reason to add this feature. Ideally, you should open a suggestion issue first with the suggestion or feature request tag and have it approved before working on it.

• If fixing bug:

  • If you are resolving a special issue, add (fix #xxxx[,#xxxx]) (#xxxx is the issue id) in your PR title for a better release log, e.g. update entities encoding/decoding (fix #3899).
  • Provide a detailed description of the bug in the PR.

Development Setup #

You will need PHP 7.2 + and composer.

After cloning the repo, run:

composer install

Project Structure #

• src: contains the source code.

  • Exception/: contains code for the general leaf exceptions.

    This contains default error states and screens for errors, down-times and the like. It also contains extensible mark-up and logging to keep track of errors. Basically, anything relating to errors.

  • Helpers/: contains default leaf utilities like the container (DI container).

  • App.php: contains initializers and main leaf code.

  • Config.php: class for configuring how leaf behaves.

  • functions.php: Base functions for functional mode.

  • Middleware.php: base class for creating leaf middleware.

  • View.php: view config for leaf.

Financial Contribution #

As a pure community-driven project without any corporate backing, we also welcome financial contributions via OpenCollective.

• Checkout our sponsor page

Credits #

Thank you to all the people who have already contributed in code or cash to Leaf!

Michael Darko	Matthew Reichardt	Ademílson F. Tonato	Tobias Herber
Pjotr Savitski	Pablo Ferreiro	jess	Sergey Romanenko
Ashley	Ivan Brykov	Nur Muhammad	Mauro Callegari
Aminur Rahaman	Divine Niiquaye Ibok	Rai-Rai	Wahyu Kristianto
Muhammad Ezha Syafaat	Rafael M.	Pisyek K.	wfsdaj
Aaron Smith	Peter Bogner	Vano	Casprine