diff --git a/README.md b/README.md
index f013247..179977b 100644
--- a/README.md
+++ b/README.md
@@ -177,12 +177,24 @@ update (state, {type, params}) {
   switch (type) {
     case '@@attr/some-custom-attribute':
       return {count: state.count + parseInt(params)}
-    case default: return state
+    default: return state
   }
 }
 ```
 
+## Listening to the attached event
+A special action `@@attached` is fired when the component is attached into the DOM. 
+The `param` for this action is the instance of the web component.
 
+```js
+update (state, {type, params}) {
+  switch (type) {
+    case '@@attached':
+      return {width: params.getBoundingClientRect().width}
+    default: return state
+  }
+}
+```
 
 
 <a name="module_raf"></a>
diff --git a/docs/README.template.md b/docs/README.template.md
index b6bb4b9..034084c 100644
--- a/docs/README.template.md
+++ b/docs/README.template.md
@@ -177,12 +177,24 @@ update (state, {type, params}) {
   switch (type) {
     case '@@attr/some-custom-attribute':
       return {count: state.count + parseInt(params)}
-    case default: return state
+    default: return state
   }
 }
 ```
 
+## Listening to the attached event
+A special action `@@attached` is fired when the component is attached into the DOM. 
+The `param` for this action is the instance of the web component.
 
+```js
+update (state, {type, params}) {
+  switch (type) {
+    case '@@attached':
+      return {width: params.getBoundingClientRect().width}
+    default: return state
+  }
+}
+```
 
 
 {{>main}}