diff --git a/README.md b/README.md
new file mode 100644
index 0000000..509faec
--- /dev/null
+++ b/README.md
@@ -0,0 +1,5 @@
+# securerandomstring
+a node module that generates a secure random string with a given length
+
+## usage
+see `tests.js`