diff --git a/readme.md b/readme.md
index 81b8580..4cc9d63 100644
--- a/readme.md
+++ b/readme.md
@@ -24,6 +24,38 @@ issues? contact us at [@openlibrecommunity](https://t.me/openlibrecommunity)
 or wait for the release or at least a beta
 
 
+## magefile
+
+```bash
+# install mage first
+go install github.com/magefile/mage@latest
+
+# build cli + ui
+mage build
+
+# build cli only
+mage buildCLI
+
+# build ui only
+mage buildUI
+
+# cross-compile for linux / windows / darwin
+mage cross
+
+# android aar via gomobile
+mage mobile
+
+# container image
+mage podman
+mage docker
+
+# lint / test / clean
+mage lint
+mage test
+mage clean
+```
+
+
 ## fast start
 
 ```bash
@@ -47,8 +79,6 @@ or wait for the release or at least a beta
 ./build/olcrtc-ui
 
 
-
-
 # or native ( no podman ) linux
 GOOS=linux GOARCH=amd64 go build ./cmd/olcrtc