diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a447dd0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,29 @@
+# letterboxd user block
+
+Block letterboxd users that don't want to see reviews from
+
+## Install
+
+	$ npm install
+
+## Development
+
+    npm run dev chrome
+    npm run dev firefox
+    npm run dev opera
+    npm run dev edge
+
+## Build
+
+    npm run build chrome
+    npm run build firefox
+    npm run build opera
+    npm run build edge
+
+## Environment
+
+The build tool also defines a variable named `process.env.NODE_ENV` in your scripts. 
+
+## Docs
+
+* [webextension-toolbox](https://github.com/HaNdTriX/webextension-toolbox)