Contributing

Winnux welcomes contributions from everyone. Here is how you can help.

Ways to contribute

• Code: Rust system services, QML applications, build system
• Documentation: Guides, translations, API documentation
• Testing: QEMU testing, hardware testing, bug reports
• Design: UI/UX, icons, branding
• Translation: Swedish and other languages

Getting started

1. Read the Product Blueprint and Architecture
2. Clone the winnux-os repository
3. Read CONTRIBUTING.md and AGENTS.md
4. Find an issue or suggest an improvement
5. Create a branch, make changes, submit a PR

AI-assisted development

AI agents are used for research, implementation, test generation, documentation, and review. AI-generated code is not automatically trusted code. Agents may not directly modify protected production branches, handle signing keys, publish stable images, or merge their own pull requests.

Repository conventions

• Follow existing code style
• Write tests for new functionality
• Document behavior changes
• Reference the relevant ADR for architectural decisions