diff --git a/gestures.md b/gestures.md
new file mode 100644
index 0000000..d3b8bf8
--- /dev/null
+++ b/gestures.md
@@ -0,0 +1,19 @@
+### Description
+Add swipe gestures to trigger functions, similar to [libinput-gestures](https://github.com/bulletmark/libinput-gestures/tree/master). It supports the following gestures: `SWIPE_UP`, `SWIPE_DOWN`, `SWIPE_LEFT` and `SWIPE_RIGHT`
+
+```c
+static const Gesture gestures[] = {
+  /* modifier gesture       fingers_count   function    argument */
+  { MODKEY,   SWIPE_LEFT,   4,              shiftview,  { .i = 1 } },
+  { 0,        SWIPE_RIGHT,  4,              shiftview,  { .i = -1 } },
+};
+```
+
+**NOTE:** the example above requires the following patch [shiftview](https://codeberg.org/dwl/dwl-patches/wiki/shiftview)
+
+### Download
+- [git branch](https://codeberg.org/wochap/dwl/src/branch/v0.5/gestures)
+- [2024-03-12](https://codeberg.org/dwl/dwl-patches/raw/branch/main/gestures/gestures.patch)
+
+### Authors
+- [wochap](https://codeberg.org/wochap)