The Orchid project thrives on community collaboration. We invite you to participate in open discussions, ask questions, and propose ideas in our GitHub discussions. Your input can shape the future of Orchid!
If you encounter any bugs or have specific feature requests, please check our issues tracker. You can find unresolved issues and indicate your intention to work on a specific problem by leaving a comment on the relevant task.
For active development, we encourage you to use
pull requests instead of solely reporting bugs. This collaborative approach helps us work together efficiently to resolve issues and enhance Orchid.
When submitting a bug report, it is crucial to provide concise yet comprehensive details. To ensure your report is helpful for developers, make sure they can easily reproduce the issue. Be sure to include step-by-step instructions to replicate the problem. We kindly ask you to report bugs in English, while keeping an eye on your grammar and language usage.
Remember, bug reports are meant to encourage collaboration and allow other users with similar issues to participate in finding solutions. While we appreciate your enthusiasm, it’s important to note that others may not be able to immediately drop their work and address your specific problem. Bug reports serve as a starting point for cooperative problem-solving.
If you discover any security vulnerabilities within the platform, please promptly send an email to
email@example.com. We take all security concerns seriously and will promptly address them.
When contributing to the project, you might encounter issues related to debugging and installation. This section aims to assist you in submitting your first change request.
To install the Laravel Orchid package as a developer, you’ll need to have a Laravel framework installation.
Before making changes, fork the GitHub repository and create a clone of it.
Navigate to the root directory of your fresh Laravel installation and execute the following command:
git clone https://github.com/yourname/platform.git
Next, add a local repository to the
composer.json file of your Laravel project to point the Orchid platform to your locally cloned fork:
Lastly, include our package by executing the following command:
composer require orchid/platform:@dev
Composer will add the package from the repository you specified. Follow the rest of the installation instructions in the “Installation” section.
npm run dev --prefix platform && php artisan orchid:publish
First you need to check the code style (Laravel Pint is used for this)
Run check and fix:
Run on specific files or directories:
Next you need to check the execution of unit tests:
Create a new branch that indicates the added functionality or fixes the issue. Use the following command:
git checkout -b feature/issue_001
This branch name will signify that you’re addressing a specific functionality related to message number 001.
Make your changes and commit them:
git commit -am 'ref #001 [Docs] Fix typo'
To submit your branch for review, execute the following command:
git push origin feature/issue_001
We appreciate your contributions in translating Orchid into multiple languages. Visit the Make Orchid (more) International conversation on the Discussion tab for more details. Translation files can be found in the resources/lang directory.
To begin translating, follow the steps outlined in the “Development Installation” section to create a development installation. Create a new branch for your translation:
git checkout -b feature/translation_nl
Once you’ve completed the translation, submit it as a change request following the instructions mentioned earlier.
We appreciate your dedication to making Orchid accessible to a broader audience. Your translations will help us reach more users around the world.
We hope this detailed documentation helps you contribute effectively and participate in the growth of Orchid. We value your time and effort in making Orchid better and more user-friendly. Thank you for being part of our community!