diff --git a/README.md b/README.md
index 21b830e..9e8a984 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,42 @@
-# dotfiles-i3
+# I3 Dotfiles
 
+Конфигурационные файлы для тайлингового оконного менеджера i3 и сопутствующего окружения. Настройка ориентирована на производительность и работу с мультимониторной конфигурацией.
+
+<p align="center">
+  <img src="./assets/monitor_0.jpg" alt="i3wm Desktop Preview" width="800">
+</p>
+
+## Стек
+
+| Компонент | Технология
+| :--- | :--- |
+| **Window Manager** | i3 |
+| **Status Bar** | Polybar |
+| **Compositor** | Picom |
+| **State Management** | Python / Socat |
+| **Notification** | Dunst |
+| **Application Launcher** | Rofi |
+
+## Структура репозитория
+```bash
+.
+├── i3/         # Основной конфиг WM и скрипты автоматизации
+├── polybar/    # Конфигурация панелей и модулей (CPU, RAM, GPU temp)
+├── picom/      # Настройки композитинга (тени, прозрачность, размытие)
+├── rofi/       # Темы и настройки меню запуска
+├── dunst/      # Конфигурация уведомлений
+└── assets/     # Вспомогательные файлы
+```
+
+## Основные зависимости
+
+Для полной работоспособности функций управления и скриптов необходимы:
+
+```bash
+pactl # audio control
+playerctl # media control
+feh # wallpaper
+xclip # clipboard interaction
+nvidia-smi # для мониторинга температуры GPU
+xidlehook # idle management
+```
\ No newline at end of file
diff --git a/assets/monitor_0.jpg b/assets/monitor_0.jpg
new file mode 100644
index 0000000..3172be4
Binary files /dev/null and b/assets/monitor_0.jpg differ