Adding a new UI
Appearance
Overview
Step-by-step guide to adding a new UI in postmarketOS (and by extension Alpine).
- If the UI isn't already packaged in Alpine aports, then
package the UI components there.
- Create a UI package in pmaports that installs the components and add a config to start and manage it.
- Add it's systemd service if the UI doesn't provide one.
- Add the UI to the pmaports issue template.
- Create a wiki page for the UI (example: COSMIC).
- Create a Gitlab label for the UI. Only Core contributors can do this so please reach out to one of them for help.
- Consider enabling pre-built images for the UI.
See also
From the process of adding the COSMIC desktop:
- aports!80719 Add COSMIC desktop environment
- pmaports!6274 Add support for the COSMIC desktop environment
- build.postmarketos.org!124 images: add COSMIC UI for laptop and convertible chassis