Jump to content

Adding a new UI

From postmarketOS Wiki

Overview

Step-by-step guide to adding a new UI in postmarketOS (and by extension Alpine).

  1. If the UI isn't already packaged in Alpine aports, then package the UI components there.
  2. Create a UI package in pmaports that installs the components and add a config to start and manage it.
    1. Add it's systemd service if the UI doesn't provide one.
    2. Add the UI to the pmaports issue template.
  3. Create a wiki page for the UI (example: COSMIC).
  4. Create a Gitlab label for the UI. Only Core contributors can do this so please reach out to one of them for help.
  5. Consider enabling pre-built images for the UI.

See also

From the process of adding the COSMIC desktop: