diff --git a/docs/assets/swappy.gif b/docs/assets/swappy.gif
new file mode 100644
index 0000000..59c1664
Binary files /dev/null and b/docs/assets/swappy.gif differ
diff --git a/docs/intro.md b/docs/intro.md
index b40af56..666f028 100644
--- a/docs/intro.md
+++ b/docs/intro.md
@@ -132,6 +132,16 @@ You can use position absolute for specific widget by checking the absolute posit
 
 ![Absolute positioning](./assets/absolute-position.png)
 
+### Swapping widgets on flex layout
+
+You can swap widget by bringing the widget near the edge of the other widget. 
+
+<div class="alert alert-warning">
+  <div class="alert-title">Warning ⚠️</div>
+  This feature is still work in progress and sometimes may not work as expected
+</div>
+
+![Swappy](./assets/swappy.gif)
 
 ## Plugins