diff --git a/README.md b/README.md
index e69de29..08db2a8 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,5 @@
+![crux_ports](images/crux_ports.png)
+
+# CRUX ports
+
+The files needed for [building a package](https://crux.nu/Main/Handbook3-7#ntoc49) using `pkgmk`
diff --git a/images/crux.png b/images/crux.png
new file mode 100644
index 0000000..0aab3c2
Binary files /dev/null and b/images/crux.png differ
diff --git a/images/crux_ports.png b/images/crux_ports.png
new file mode 100644
index 0000000..00b63b7
Binary files /dev/null and b/images/crux_ports.png differ