diff --git a/README.md b/README.md
new file mode 100644
index 0000000..bfb47d3
--- /dev/null
+++ b/README.md
@@ -0,0 +1,13 @@
+# to build
+
+```default
+docker compose up --build
+```
+
+Then find the binaries in `./opt`.
+
+# to troubleshoot
+
+```default
+docker compose run --entrypoint bash swayfxbuild
+```