diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d5e587f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,20 @@
+# object with default value
+
+```js
+const objectDefault = require('object-with-default-value')
+
+const lol = objectDefault({a: 1, b: 2, c: 3}, 100)
+
+console.log(lol.a) // 1
+console.log(lol.b) // 2
+console.log(lol.wow) // 100
+```
+
+you can still set things like normal:
+
+```js
+console.log(lol.dog) // 100
+lol.dog = 'henry'
+console.log(lol.dog) // "henry"
+```
+