diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0193007
--- /dev/null
+++ b/README.md
@@ -0,0 +1,9 @@
+# Logos Blockchain Module
+
+### Setup
+
+#### IDE
+
+If you're using an IDE with CMake integration make sure it points to the same cmake directory as the `justfile`, which defaults to `build`.
+
+This will reduce friction when working on the project.