diff --git a/repo/dotfiles/README.md b/repo/dotfiles/README.md
index e69de29b..e031db35 100644
--- a/repo/dotfiles/README.md
+++ b/repo/dotfiles/README.md
@@ -0,0 +1,22 @@
+# My dotfiles
+
+User-specific application configuration is traditionally stored in so called [dotfiles](https://en.wikipedia.org/wiki/dotfile) (files whose filename starts with a dot). It is common practice to track dotfiles with a [version control system](https://wiki.archlinux.org/title/Version_control_system) such as [Git](https://wiki.archlinux.org/title/Git) to keep track of changes and synchronize dotfiles across various hosts.
+
+![](./theme.png)
+
+## Installation
+
+ **Note:** Installer-script is in the works. In order to apply the themes just copy the folders to its specific location
+
+````bash
+git clone https://github.com/botchGNU/dotfiles.git
+bash install.sh
+````
+
+## Used materials
+
+- xfce-superkey
+- [DemonCloud's Vim Dotfiles](https://github.com/DemonCloud/dotfile)
+- [oh-my-zsh](https://github.com/ohmyzsh/ohmyzsh)
+- [WinXP icon theme pack](https://store.kde.org/p/1215836/)
+-