diff --git a/README.md b/README.md
index 46b01da47..9933c753c 100644
--- a/README.md
+++ b/README.md
@@ -3,8 +3,8 @@
 ```
 
 <div align="center">
-<img src="https://raw.githubusercontent.com/reflex-dev/reflex/main/docs/images/reflex_dark.svg#gh-light-mode-only" alt="Reflex Logo" width="300px">
-<img src="https://raw.githubusercontent.com/reflex-dev/reflex/main/docs/images/reflex_light.svg#gh-dark-mode-only" alt="Reflex Logo" width="300px">
+<img src="https://raw.githubusercontent.com/reflex-dev/reflex/main/readme/images/reflex_dark.svg#gh-light-mode-only" alt="Reflex Logo" width="300px">
+<img src="https://raw.githubusercontent.com/reflex-dev/reflex/main/readme/images/reflex_light.svg#gh-dark-mode-only" alt="Reflex Logo" width="300px">
 
 <hr>
 
@@ -18,7 +18,7 @@
 
 ---
 
-[English](https://github.com/reflex-dev/reflex/blob/main/README.md) | [简体中文](https://github.com/reflex-dev/reflex/blob/main/docs/zh/zh_cn/README.md) | [繁體中文](https://github.com/reflex-dev/reflex/blob/main/docs/zh/zh_tw/README.md) | [Türkçe](https://github.com/reflex-dev/reflex/blob/main/docs/tr/README.md) | [हिंदी](https://github.com/reflex-dev/reflex/blob/main/docs/in/README.md) | [Português (Brasil)](https://github.com/reflex-dev/reflex/blob/main/docs/pt/pt_br/README.md) | [Italiano](https://github.com/reflex-dev/reflex/blob/main/docs/it/README.md) | [Español](https://github.com/reflex-dev/reflex/blob/main/docs/es/README.md) | [한국어](https://github.com/reflex-dev/reflex/blob/main/docs/kr/README.md)
+[English](https://github.com/reflex-dev/reflex/blob/main/README.md) | [简体中文](https://github.com/reflex-dev/reflex/blob/main/readme/zh/zh_cn/README.md) | [繁體中文](https://github.com/reflex-dev/reflex/blob/main/readme/zh/zh_tw/README.md) | [Türkçe](https://github.com/reflex-dev/reflex/blob/main/readme/tr/README.md) | [हिंदी](https://github.com/reflex-dev/reflex/blob/main/readme/in/README.md) | [Português (Brasil)](https://github.com/reflex-dev/reflex/blob/main/readme/pt/pt_br/README.md) | [Italiano](https://github.com/reflex-dev/reflex/blob/main/readme/it/README.md) | [Español](https://github.com/reflex-dev/reflex/blob/main/readme/es/README.md) | [한국어](https://github.com/reflex-dev/reflex/blob/main/readme/kr/README.md)
 
 ---
 ## ⚙️ Installation
@@ -61,7 +61,7 @@ Let's go over an example: creating an image generation UI around [DALL·E](https
 &nbsp;
 
 <div align="center">
-<img src="https://raw.githubusercontent.com/reflex-dev/reflex/main/docs/images/dalle.gif" alt="A frontend wrapper for DALL·E, shown in the process of generating an image." width="550" />
+<img src="https://raw.githubusercontent.com/reflex-dev/reflex/main/readme/images/dalle.gif" alt="A frontend wrapper for DALL·E, shown in the process of generating an image." width="550" />
 </div>
 
 &nbsp;
diff --git a/docs/DEBUGGING.md b/readme/DEBUGGING.md
similarity index 100%
rename from docs/DEBUGGING.md
rename to readme/DEBUGGING.md
diff --git a/docs/es/README.md b/readme/es/README.md
similarity index 100%
rename from docs/es/README.md
rename to readme/es/README.md
diff --git a/docs/images/dalle.gif b/readme/images/dalle.gif
similarity index 100%
rename from docs/images/dalle.gif
rename to readme/images/dalle.gif
diff --git a/docs/images/reflex.png b/readme/images/reflex.png
similarity index 100%
rename from docs/images/reflex.png
rename to readme/images/reflex.png
diff --git a/docs/images/reflex_dark.svg b/readme/images/reflex_dark.svg
similarity index 100%
rename from docs/images/reflex_dark.svg
rename to readme/images/reflex_dark.svg
diff --git a/docs/images/reflex_light.svg b/readme/images/reflex_light.svg
similarity index 100%
rename from docs/images/reflex_light.svg
rename to readme/images/reflex_light.svg
diff --git a/docs/in/README.md b/readme/in/README.md
similarity index 100%
rename from docs/in/README.md
rename to readme/in/README.md
diff --git a/docs/it/README.md b/readme/it/README.md
similarity index 100%
rename from docs/it/README.md
rename to readme/it/README.md
diff --git a/docs/kr/README.md b/readme/kr/README.md
similarity index 100%
rename from docs/kr/README.md
rename to readme/kr/README.md
diff --git a/docs/pt/pt_br/README.md b/readme/pt/pt_br/README.md
similarity index 100%
rename from docs/pt/pt_br/README.md
rename to readme/pt/pt_br/README.md
diff --git a/docs/tr/README.md b/readme/tr/README.md
similarity index 100%
rename from docs/tr/README.md
rename to readme/tr/README.md
diff --git a/docs/zh/zh_cn/README.md b/readme/zh/zh_cn/README.md
similarity index 100%
rename from docs/zh/zh_cn/README.md
rename to readme/zh/zh_cn/README.md
diff --git a/docs/zh/zh_tw/README.md b/readme/zh/zh_tw/README.md
similarity index 100%
rename from docs/zh/zh_tw/README.md
rename to readme/zh/zh_tw/README.md