diff --git a/README.md b/README.md
index 96bf7ed..d352271 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,13 @@
 # dotfiles
+
+Personal configuration files for macOS development environment.
+
+## Structure
+
+- **alacritty/** - Terminal emulator configuration
+- **bin/** - Custom scripts and executables
+- **nvim/** - Neovim editor configuration with plugins
+- **skhd/** - Simple hotkey daemon for macOS keyboard shortcuts
+- **tmux/** - Terminal multiplexer configuration
+- **yabai/** - Tiling window manager for macOS
+- **zsh/** - Zsh shell configuration and profile