diff --git a/README.md b/README.md
new file mode 100644
index 0000000..baf784b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,14 @@
+# Utilities
+
+General helper functions
+
+```
+const util = require('@scode/utilities');
+
+// cut off decimal places to a specified point
+util.truncate_decimal(12.345678, 2);
+// returns 12.34
+
+// will return null instead of throwing on invalid json
+util.try_parse_json('{{foo');
+```