Contributing to Mantle OS

Where We Are

Mantle OS is still deep in its Hadean phase — molten, chaotic, and forming new layers daily. Right now, we’re stabilizing our foundations: reproducible builds, Exos tooling, and vendor BSP integration.

Contributions are absolutely welcome, but patience and curiosity go a long way here. Things are still fluid, and sometimes they’ll melt and reform overnight.

How to Get Involved

1. Visit our GitLab and explore the projects under mantle-os/.
2. Check the README.md and CONTRIBUTING.md files (where available) for repository-specific guidance.
3. For Exos, see exos/ — it’s the orchestration layer for all builds and CI/CD work.
4. Open issues or merge requests for small, clear changes first — documentation, fixes, or build recipes.
5. Stay close to the Yocto LTS cycle — each Mantle branch maps directly to an upstream LTS.

We welcome contributions in all forms — code, testing, documentation, and even geological puns.

Development Principles

• Transparency — All work happens in the open, through GitLab.
• Reproducibility — Every build can be recreated exactly using Exos containers.
• Layered Architecture — Code and infrastructure mirror Earth’s own design: core, mantle, crust, exosphere.
• Freedom — Built on “free as in freedom,” not “free as in beer.”
• Patience — Good geology takes time. So does good engineering.

Need Help?

You can reach out through GitLab issues or discussions. We’re a small but growing community of embedded Linux engineers, systems tinkerers, and people who just like watching code solidify.