diff --git a/README.md b/README.md
new file mode 100644
index 0000000..01571d3
--- /dev/null
+++ b/README.md
@@ -0,0 +1,31 @@
+# WoW UI Configuration Pack
+
+This repository contains my personal **World of Warcraft UI configurations**, profiles, and layout exports.
+
+The goal of this repo is to:
+- Keep UI profiles version-controlled
+- Make rebuilding a UI fast after patches / fresh installs
+- Share or migrate configs across machines
+
+All addon profiles, exports, and notes live inside their **respective addon folders**.
+
+---
+
+## 📸 UI Preview
+
+### Main Layout
+![WoW UI Preview](https://git.makesandcrafts.com/aron/WoW-UI/raw/branch/main/Preview-Images/WoWScrnShot_012526_110559.jpg)
+
+<!--
+If you add more images later, just duplicate the block below:
+
+![WoW UI Preview](https://git.makesandcrafts.com/aron/WoW-UI/raw/branch/main/Preview-Images/IMAGE_NAME.jpg)
+-->
+
+---
+
+## 📂 Repository Structure
+
+Each addon has its **own folder**, containing:
+- Profile export(s)
+- Configuration notes
\ No newline at end of file