diff --git a/README.md b/README.md
index 4da18ac..c2f300e 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,42 @@
-# safer-web-storage
\ No newline at end of file
+# safer-web-storage
+
+Browsers that support `localStorage` and `sessionStorage` will have a property on the window object named respectively. However, for various reasons, just asserting that property exists may throw exceptions. If it does exist, that is still no guarantee that localStorage is actually available, as various browsers offer settings that disable storages. So a browser may support localStorage, but not make it available to the scripts on the page. One example of that is Safari, which in Private Browsing mode gives us an empty localStorage object with a quota of zero, effectively making it unusable.
+
+## Installation and Usage
+
+```bash
+npm install safer-web-storage
+```
+
+```javascript
+import * as SafeStorage from 'safer-web-storage'
+
+const safeLocalStorage = SafeStorage.createSafeLocalStorage()
+const safeSessionStorage = SafeStorage.createSafeSessionStorage()
+
+safeLocalStorage.getItem('apples')
+safeSessionStorage.seItem('pineapples', 20)
+```
+
+If either `window.sessionStorage` or its methods are not accessible, it swaps to in-memory storage.
+
+This wrapper supports all methods and properties of [Web Storage API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Storage_API/Using_the_Web_Storage_API):
+
+- `getItem`
+- `setItem`
+- `removeItem`
+- `key`
+- `clear`
+- `length`
+
+## API
+
+### createSafeLocalStorage(options) => Storage
+
+### createSafeSessionStorage(options) => Storage
+
+You can pass the following properties to `options`:
+
+| Name           | Type   | Default                                                                      | Description                                                                |
+| -------------- | ------ | ---------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
+| `errorMessage` | String | Looks like you've disabled \<StorageType\>. Enable it to avoid this warning. | Error message printed to the browser console when storage is not available |
diff --git a/package.json b/package.json
index 60dec05..3619ec9 100644
--- a/package.json
+++ b/package.json
@@ -1,18 +1,23 @@
 {
   "name": "safer-web-storage",
   "version": "0.0.1",
-  "description": "Safer web storage",
+  "description": "Handle all exception when storage is not available due to user's browser settings. Swap to in-memory storage if sessionStorage is not available.",
+  "keywords": [
+    "localStorage",
+    "sessionStorage",
+    "in-memory storage"
+  ],
   "main": "src/index.js",
   "scripts": {
     "lint": "eslint .",
     "test": "jest"
   },
+  "author": "Vitalii Saienko <modestfake@gmail.com> (https://github.com/modestfake)",
+  "license": "ISC",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/modestfake/safer-web-storage.git"
   },
-  "author": "",
-  "license": "ISC",
   "bugs": {
     "url": "https://github.com/modestfake/safer-web-storage/issues"
   },