diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6ffc8f8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+# postmarketos-ui-awesome-mobile
+
+This repository is a postmarketOS/Alpine Linux package description, providing a package for (currently the git master of) [awesome-mobile](https://git.shadowkat.net/izaya/awesome-mobile) on [postmarketOS](https://postmarketos.org/)
+
+## Usage
+This repository is meant to go into the 'main' repository of the pmaports tree.
+
+```
+cd <pmaports dir>/main
+git clone https://git.shadowkat.net/izaya/postmarketos-ui-awesome-mobile.git
+...
+pmbootstrap init
+```
+
+awesome-mobile will then appear as an option in the interface selection dialog.