diff --git a/README.md b/README.md
new file mode 100644
index 0000000..72d2d7f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,20 @@
+# HRM
+
+An example heart rate monitor app for Android and MacOS using [git.wow.st/gmp/ble](git.wow.st/gmp/ble) and [Gio](gioui.org).
+
+## MacOS:
+
+```
+go get git.wow.st/gmp/hrm
+go build
+./hrm
+```
+
+## Android:
+
+```
+go get git.wow.st/gmp/hrm
+gogio -target android .
+adb install -r hrm.apk
+```
+