diff --git a/README.md b/README.md
index 071bb4a..9f75b33 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,82 @@
 # formhero
-Fully customisable React form utility
+
+Fully customisable react form utility.
+
+## ✓ Features
+
+- Typescript compatible
+- Customizable extractor, validator, getter and setters. (More in the docs)
+- No Deps
+- Miniscule ()
+
+## 🚀 Quickstart
+
+```tyimport React from 'react'
+import ReactDOM from 'react-dom'
+import { useForm } from 'formhero'
+
+const Form = () => {
+
+  const { auto, form, errors } = useForm({
+    username: '',
+    password: '',
+    type: 'formhero',
+    awesome: true,
+  }, {
+    username: /^test/,
+    password: {
+      validator: /^.{3,}$/,
+      message: 'To short',
+    },
+    awesome: (value) => !!value
+  })
+
+  const _submit = (e: React.FormEvent) => {
+    e.preventDefault()
+    console.log(form, errors)
+  }
+
+  return (
+    <div>
+      <form onSubmit={_submit}>
+        
+        <div>Username</div>
+        <input {...auto('username')} />
+        {errors.username && 'Something went wrong'}
+        <br />
+
+        <div>Password</div>
+        <input {...auto('password')} />
+        <br />
+
+        <div>Which one to choose?</div>
+        <select {...auto('type')}>
+          <option value="redux-form">Redux-Form</option>
+          <option value="react-hook-forms">React-Hook-Forms</option>
+          <option value="formik">Formik</option>
+          <option value="formhero">FormHero</option>
+        </select>
+        <br />
+
+        <div>Is it awesome?</div>
+        <input type="checkbox" name="vehicle" {...auto('awesome', {
+          setter: 'checked',
+          getter: 'onChange',
+          extractor: (e) => e.target.checked
+        })} />
+        <br />
+
+        <button type="submit">Go 🚀</button>
+      </form>
+    </div>
+  )
+}
+```
+
+## 📖 Docs
+
+### `useForm`
+
+```typescript
+const {auto, errors, update, form} = useForm(initial, validators, options)
+```