diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2cb4ceb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+# Consts
+
+A bunch of useful constants to make code more readable
+
+## Modules
+
+- http: http status codes
+
+## Usage
+
+```js
+const consts = require('@scode/consts');
+
+const status = consts.http.status_ok;
+```