diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f344448
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+# 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
+cd ~/go/src/git.wow.st/gmp/hrm
+go build
+./hrm
+```
+
+## Android:
+
+The `gogio` command from `gioui.org/cmd/gogio` must be installed to build
+an Android APK.
+
+```
+go get git.wow.st/gmp/hrm
+cd ~/go/src/git.wow.st/gmp/hrm
+gogio -target android .
+adb install -r hrm.apk
+```