diff --git a/app/src/main/java/app/myzel394/alibi/ui/README.md b/app/src/main/java/app/myzel394/alibi/ui/README.md
new file mode 100644
index 0000000..bbf323c
--- /dev/null
+++ b/app/src/main/java/app/myzel394/alibi/ui/README.md
@@ -0,0 +1,14 @@
+# ui
+
+This folder contains all user interfaces. The folder is structured as follows:
+
+* `components`: contains all reusable components
+    * `atoms`, `molecules`, `organisms`, `pages`: contains components that are generic and can be
+      reused in different contexts
+    * `<name>Screen/{atoms,molecules,organisms,pages}`: contains components that are specific to a
+      screen
+* `screens`: contains all screens. Screens are composed of components from the `components` folder
+* `models`: contains view models used by the screens
+* `utils`: contains general utility functions
+
+The root Kotlin files are used for the general setup of the UI.
\ No newline at end of file