diff --git a/README.md b/README.md
index f96e739..10fc587 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,26 @@
 # ClutterDB
 extremely simple JSON database made for infrequent changes which behaves like a dict
+# Usage
+```
+from db import ClutterDB
+
+# initialization
+db = ClutterDB("path/to/json/file.json")
+
+# defining a variable 
+# (this will overrride the previous a if it was defined before)
+db.set("a", 12345)
+
+# getting a variable 
+# (default kwarg will be returned if the key was not defined in the json)
+data = db.get("a", default="a was not defined in the json")
+
+# prints data
+print(data)
+
+# removes the a from the json
+db.rem("a")
+
+# nukes the json
+db.nuke()
+```