diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8e5f608
--- /dev/null
+++ b/README.md
@@ -0,0 +1,9 @@
+# smartstream
+simplifies access to node streams, TypeScript ready!
+
+## Status
+[![build status](https://gitlab.com/pushrocks/smartstream/badges/master/build.svg)](https://gitlab.com/pushrocks/smartstream/commits/master)
+
+## Usage
+We recommend the use of TypeScript for best in class intellisense support.
+