diff --git a/system/ui/README.md b/system/ui/README.md
new file mode 100644
index 0000000000..5f47961a51
--- /dev/null
+++ b/system/ui/README.md
@@ -0,0 +1,9 @@
+# ui
+
+The user interfaces here are built with [raylib](https://www.raylib.com/).
+
+Quick start:
+* set `DEBUG_FPS=1` to show the FPS
+* set `STRICT_MODE=1` to kill the app if it drops too much below 60fps
+* https://www.raylib.com/cheatsheet/cheatsheet.html
+* https://electronstudio.github.io/raylib-python-cffi/README.html#quickstart