Skip to main content

​
Overview

Lunar is an open source project, and so by its very nature, welcomes contributions. You can contribute to the project in many different ways. Reporting bugs, fixing bugs, helping with the documentation, making suggestions and submitting improvements to the software.

​
Monorepo

Lunar uses a monorepo lunarphp/lunar approach to maintaining its codebase. Monorepos are quite common, but may not be familiar to some. The monorepo helps us to organise the code for ease of development.

​
Contributing Code

The basic process for contributing to Lunar is as follows…
  1. Fork the monorepo
  2. Clone your fork locally
  3. Make your changes
  4. Ensure the tests run and complete successfully
  5. Submit a pull request
However, if you’re not used to working with monorepo’s and setting them up inside a test Laravel application, no problem!
Here’s a guide on how to set-up your development environment ready for contributing to Lunar. Setting Up Lunar For Local Development

​
Found a Bug?

If you find a bug in the software please raise a GitHub Issue on the lunarphp/lunar repository. Please ensure that your issue includes the following: Minimum
  • Clear title and description of the issue
  • Steps on how to reproduce the issue
Ideal
  • An accompanying Pull Request with a test to demonstrate the issue.
Lunar is an open source project and as such we want contribution to be as accessible as possible and to enable contributors to actively collaborate on features and issues. By making sure you provide as much information as possible you are giving your issue the best chance to get the attention it needs. Be aware that creating an issue does not mean it will get activity straight away, please be patient and understand we will do our best to look into it as soon as possible. Open source code belongs to all of us, and it’s all of our responsibility to push it forward.

​
Proposing a Feature

Before you start coding away on the next awesome feature, we highly recommend starting a discussion to check that your contribution will be welcomed. We would hate for you to spend valuable time on something that won’t be merged into Lunar. However, you’re more than welcome to code away on your idea if you think it will help the discussion.

​
Making a Pull Request

When making a pull request, there should be a suitable template for you to follow to ensure the bug or feature can be reviewed in a timely manner. If the pull request is missing information or unclear as to what it offers or solves, it could any delay movement or be closed. A PR should be able to include the following:
  • The title should be relevant and quickly explain what to expect inside
  • A clear description of the feature or fix
  • References to any issues the PR resolves
  • Label as either a bug, enhancement, or feature
  • Any relevant documentation updates
  • Automated tests with adequate code coverage

​
Documentation

Lunar’s documentation is written in Markdown and is stored in the lunarphp/docs repository.