diff --git a/README.md b/README.md
index 3b7fe27..cb6fcfc 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,21 @@
 # c_command_pattern
 
-a simple example of how to implement the command pattern in c
\ No newline at end of file
+a simple example of how to implement the command pattern in c
+
+# how to build and run it
+
+this demo uses a simple build system called [nob](https://github.com/tsoding/nob.h) a header only build system for c projects.
+
+to build run these command in the root of the project:
+```bash
+
+# bootstraps the build system
+> gcc nob.c -o nob
+
+# runs the build system
+> ./nob
+
+# runs the program
+> ./build/main 
+
+```
\ No newline at end of file