diff --git a/modes.md b/modes.md
new file mode 100644
index 0000000..c3ec098
--- /dev/null
+++ b/modes.md
@@ -0,0 +1,34 @@
+### Description
+Implement modes, default mode is NORMAL
+
+```
+enum {
+  BROWSER,
+};
+const char *modes_labels[] = {
+  "browser",
+};
+
+static const Key keys[] = {
+  // ...
+  { MODKEY, XKB_KEY_b, entermode, {.i = BROWSER} },
+  // ...
+};
+
+static const Modekey modekeys[] = {
+  /* mode      modifier                  key                 function        argument */
+  { BROWSER, { 0, XKB_KEY_f, spawn, SHCMD("firefox") } },
+  { BROWSER, { 0, XKB_KEY_f, entermode, {.i = NORMAL} } },
+  { BROWSER, { 0, XKB_KEY_b, spawn, SHCMD("brave") } },
+  { BROWSER, { 0, XKB_KEY_b, entermode, {.i = NORMAL} } },
+  { BROWSER, { 0, XKB_KEY_g, spawn, SHCMD("google-chrome-stable") } },
+  { BROWSER, { 0, XKB_KEY_g, entermode, {.i = NORMAL} } },
+  { BROWSER, { 0, XKB_KEY_Escape, entermode, {.i = NORMAL} } },
+};
+```
+
+### Download
+- [2023-09-11](https://github.com/djpohly/dwl/compare/main...wochap:modes.patch)
+
+### Authors
+- [wochap](https://github.com/wochap)
\ No newline at end of file