Report a bug
Search the project issues first. If the bug is new, include the version, steps to reproduce it and what you expected to happen.
Built in the open
Build LuminusOS with us.
You do not need to be a programmer. A clear bug report, a tested fix, a better translation or a sharper piece of documentation can move the project forward.
Choose how you want to help
Start with the work you understand or the part of LuminusOS you already use.
Test and verify
Try releases on real hardware, reproduce reported bugs and share the exact environment and result. Testing is a contribution.
Write code
Pick one issue or one concrete problem. Read that repository’s guide, build it locally and keep the change focused.
Improve words and design
Fix documentation, translate interfaces, improve accessibility, refine icons or help make a workflow easier to understand.
From idea to contribution
A short path that works across our projects.
-
Pick a project
Choose something you use or want to learn. Each repository has its own setup and checks.
-
Check before building
Search existing issues and pull requests. For a larger change, open an issue or talk to us on Matrix first.
-
Solve one problem
Keep the patch small enough to explain and review. Describe the problem and the user-visible result.
-
Test what changed
Run the repository checks and record what you tested. Screenshots help when behavior or appearance changes.
-
Open the pull request
Explain the change, include the test evidence and respond to review. Review improves the work; reviewers want your patch to land.
Find the right repository
The project guide contains its development setup, architecture and required checks.
LuminusOS Images
System images, editions, package choices and release validation.
Read the contribution guide ↗Aurora Shell
GNOME Shell modules, desktop behavior, accessibility and JavaScript.
Read the contribution guide ↗Sirius
The installer, storage flows, translations and hardware testing.
Read the contribution guide ↗Aetheris
Kubernetes workflows built with Rust, GTK4 and Libadwaita.
Read the contribution guide ↗Website and docs
Project pages, release posts, documentation, translations and web accessibility.
Open the repository ↗Not sure where to start?
Tell us what you use and what you would like to improve. We can point you to the right repository or a small first task.