Adding a new KDE project
How to make your project be a part of the KDE community
Last updated
How to make your project be a part of the KDE community
Last updated
To add a new application or library to the KDE ecosystem, follow the Incubator and/or KDE Review processes as described below.
You will need a to use .
For projects which started outside of KDE.
You can learn how to create CI jobs for REUSE compliance following the .
"Candidate" Phase
Send an email to kde-devel@kde.org and other relevant lists requesting a sponsor pointing to the issue and including the same background description.
Agree with the sponsor which of the boxes in the checklist is already complete and put X in those.
"Incubating" Phase
During this phase, the sponsor actively works toward getting the project set up by doing the following:
Making sure the project developers have developer accounts
Contacting sysadmin to get Git repos (in the playground area) set up for the developers
Following the process to make sure it's going in the right direction and not getting stalled
At this point, the project cannot yet use the KDE brand or have a top level website on kde.org. If the project becomes stalled or does not conform to the manifesto, it gets archived (see below).
Either the owner or the sponsor can edit the checklist as the items get completed.
"Active" Phase
During the Active phase, the project enters Playground. When it is nearing a beta release it can be moved to KDE Review. The project team is assumed and expected to behave like other KDE teams and respect the KDE manifesto.
A project is considered stalled when for one year, there is no release, no commits, and no mailing-list activity. Current maintainers are contacted to check what's happening. If there is no activity or no reply from existing maintainers, after a month then a call to new maintainers is done. If a new maintainer shows up he or she gets a six month trial. If after a month no new maintainer showed up, the project gets archived.
When a project gets archived, the source repo gets closed, the mailing list disabled, and only the last download is available. If someone wants to pick it up, it goes back to the "Candidate" phase.
Notes
For any project to become an official part of KDE.
Make fixes to issues people bring up or provide explanation why they are not (yet) fixed
Wait at least two weeks in KDE Review
After two months in KDE Review the repo should be moved back to playground or moved to unmaintained
Create a project on and import the existing code. This can be in a personal space on KDE Invent. You might need to ask sysadmin to import the code.
Create an issue on the KDE Invent project with a label of "Incubation Request". Copy the checklist above and paste it into the issue without checking anything first, then include background on the project: a description of the project to be incubated, a list of the people committing to the project, and a plan to be in compliance with the . The project must be hosted or moved to KDE infrastructure (or have an action plan that ensures continuity). In other words, code should be in KDE Invent instead of Github, the issue tracker should be in the instead of Github Issues, etc.
Here are which led to the current process.
Projects move into KDE Review when they are ready to start making beta or stable releases. It allows for the KDE community to check over for minimum standards. If you have any translations notify the to move the translations.
File an issue in your project and Label it "KDE Review Request" and paste the requirements list above into it without checking anything on it
You can change the projectpath
in by editing metadata.yaml
for the project. See or file a
E-mail and other relevant mailing lists with details of your project and what the expected destination is for the repo