diff --git a/Readme.md b/Readme.md
new file mode 100644
index 0000000..759ef3e
--- /dev/null
+++ b/Readme.md
@@ -0,0 +1,41 @@
+# luci-theme-material3
+A Material Design 3 theme for OpenWrt Luci.
+
+This is a personal project based on the LuCI Bootstrap theme, imitating the Material Design 3 style. Since I'm not very familiar with web theme design, the CSS code might be a bit messy. Some of the project code was completed with the assistance of Cursor AI.
+
+
+## ✨ Preview
+<table>
+  <tr>
+    <th>🖥️ Desktop</th>
+    <th>📱 Mobile</th>
+  </tr>
+  <tr>
+    <td><img src="imgs/md3-desktop-overview.jpg" style="max-height: 600px;" /></td>
+    <td><img src="imgs/md3-mobile-overview.jpg" style="max-height: 600px;" /></td>
+  </tr>
+</table>
+
+### 🎨 All color schemes
+<table>
+  <tr>
+    <td><img src="imgs/md3-mobile-default.jpg" /></td>
+    <td><img src="imgs/md3-mobile-blue.jpg" /></td>
+    <td><img src="imgs/md3-mobile-green.jpg" /></td>
+    <td><img src="imgs/md3-mobile-red.jpg" /></td>
+  </tr>
+</table>
+
+### 📝 ToDo
+- [ ] Dark themes
+- [ ] Fix some style issues
+- [ ] Add more color schemes
+- [ ] Improve to be closer to MD3 principles
+- [ ] Optimize CSS...
+
+## 🙏 Credits
+- [OpenWrt Luci](https://github.com/openwrt/luci)
+- [Cursor](https://www.cursor.com/)
+- [MDUI](https://www.mdui.org/zh-cn/)
+- [Material Design 3](https://m3.material.io/)
+- [Reddit - LuCI theme bootstrap: Some modifications using userstyle](https://www.reddit.com/r/openwrt/comments/qmtmpf/lucithemebootstrap_some_modifications_using/)
diff --git a/imgs/md3-desktop-overview.jpg b/imgs/md3-desktop-overview.jpg
new file mode 100644
index 0000000..ae7e7cb
Binary files /dev/null and b/imgs/md3-desktop-overview.jpg differ
diff --git a/imgs/md3-mobile-blue.jpg b/imgs/md3-mobile-blue.jpg
new file mode 100644
index 0000000..ce0927d
Binary files /dev/null and b/imgs/md3-mobile-blue.jpg differ
diff --git a/imgs/md3-mobile-default.jpg b/imgs/md3-mobile-default.jpg
new file mode 100644
index 0000000..f22b480
Binary files /dev/null and b/imgs/md3-mobile-default.jpg differ
diff --git a/imgs/md3-mobile-green.jpg b/imgs/md3-mobile-green.jpg
new file mode 100644
index 0000000..2deb0b2
Binary files /dev/null and b/imgs/md3-mobile-green.jpg differ
diff --git a/imgs/md3-mobile-overview.jpg b/imgs/md3-mobile-overview.jpg
new file mode 100644
index 0000000..8d26b17
Binary files /dev/null and b/imgs/md3-mobile-overview.jpg differ
diff --git a/imgs/md3-mobile-red.jpg b/imgs/md3-mobile-red.jpg
new file mode 100644
index 0000000..67fe159
Binary files /dev/null and b/imgs/md3-mobile-red.jpg differ