Contributing to Gladys

We’re thrilled to have you here! 🎉
Open-source thrives when passionate people like you get involved — whether you're fixing bugs, adding features, or just sharing ideas. Thank you!

Here’s how you can contribute to Gladys:

🐞 Report bugs
💬 Discuss improvements or architecture
🔧 Submit bug fixes or improvements
✨ Propose new features
🤝 Become a long-term contributor or maintainer

💻 We Use GitHub for Everything

Gladys is fully managed on GitHub.
We use it to:

Host the code
Track bugs
Collaborate on pull requests

🛠️ Set Up Your Development Environment

Ready to contribute code? Start by setting up your local dev environment:

MacOS/Linux setup guide
Windows setup guide

🚀 Before Submitting a Pull Request

We recommend starting with a quick discussion on the Gladys forum to make sure your idea aligns with ongoing development:

Forum (English)
Forum (Français)

Then, follow our guide:

👉 How to contribute a new service

💡 As soon as you have some code, feel free to open a Draft Pull Request. This allows the team to follow your progress and provide early feedback.

📜 Licensing

All contributions to Gladys are submitted under the Apache 2.0 License.
By submitting a pull request, you agree to license your code under the same terms.

🐛 Reporting Bugs

We use GitHub Issues to track bugs.

To report a bug:

Head over to the issues tab
Click on New Issue
Describe the problem clearly
Hit submit — that’s it!

Thanks again for helping us make Gladys better ❤️

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!