Getting Started
BlossomOS is based on Fedora Linux. Thank you for your interest in contributing!
What is BlossomOS?
BlossomOS is a Fedora-based desktop platform built around digital independence and ease of use. It ships with a customized KDE Plasma environment (BlossomUI) and Arc, a software manager that makes installing any app a one-click experience.
Repositories
- blossom/help - This documentation site.
- blossom/arc-store/arc - Arc, the BlossomOS software manager and app store.
- blossom/ui/desktop-theme - BlossomUI, the KDE Plasma theme and desktop configuration.
Prerequisites
Fedora / RPM ecosystem
BlossomOS is Fedora-based. Familiarity with dnf and RPM packaging helps for system-level contributions.
Git and Blossom Git
All development is tracked with Git and hosted on Blossom Git. You’ll need a Blossom Git account to open pull requests.
KDE / Qt (for UI contributions)
BlossomUI is built on KDE Plasma. Qt and QML knowledge is needed for theme and widget contributions.
Contributing
- Fork the relevant repository on Blossom Git
- Clone your fork and install the build dependencies listed in the repo’s
README - Create a branch for your feature or fix. Keep it focused on one thing
- Make your changes and commit with a clear English commit message
- Open a pull request on Blossom Git and describe what you changed and why
Guidelines
- Follow the existing code style in each repository
- Commit messages in English
- One feature or fix per pull request
- Update documentation when changing user-facing behavior
Recommmendations
Help guide
If you want to edit the help guide you can also use Obsidian to edit the .svx files in the content directory directly. You will profit from WYSIWYG editing, Git integration and more.
Reporting Issues
Found a bug? Open an issue in the relevant Blossom Git repository. Include the BlossomOS version, steps to reproduce, and what you expected to happen.