diff --git a/README.md b/README.md
index 90493cd..0917b64 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,28 @@
 # cbt
 Cross-Blockchain Transactions
+
+blocklite (src.com.nvada.blocklite) is the main driver of the code
+
+## To Run code via the terminal
+- Open the run.sh file using any text editor
+- Navigate inside the CBT unzipped directory/folder
+- Run the codes line by line
+   You can start running from line 18
+- Include the parameters shown in the GUI (the port numbers must be different) and press Start
+
+## To Run code via the GUI using IDE (e.g., Eclipse)
+- Open the unzipped folder of the folder in Eclipse
+- Navigate to src/com/nvada/blocklite/frame (com.nvada.blocklite.frame) and run IndexFrame.java as a Java Application
+- Include the parameters shown in the GUI (the port numbers must be different) and press Start
+
+when you run the GUI without a Hub, the task count specifies the number of transactions
+
+## Data (downloaded from the internet) diectory has all the input data
+- export-token.csv ---- real transaction history about ETC
+- orders.csv ---- real transaction history about bitcoin
+
+libs folder has all the dependencies
+
+log folder stores the detailed exection not the ouput results
+
+resources folder is for configuring port numbers