diff --git a/README.md b/README.md
new file mode 100644
index 0000000..913b0ea
--- /dev/null
+++ b/README.md
@@ -0,0 +1,42 @@
+# Gitea Matrix Template - Make your Gitea cooler
+## Previews:
+
+![preview 1](preview\homepage.png "Preview")
+
+![preview 2](preview\explore.png "Preview")
+
+![preview 3](preview\login.png "Preview")
+
+![preview 4](preview\signedhomepage.png "Preview")
+
+![preview 5](preview\repopage.png "Preview")
+
+![preview 6](preview\markdowneditor.png "Preview")
+
+![preview 7](preview\profilepage.png "Preview")
+
+![preview 8](preview\settingpage.png "Preview")
+
+
+
+## For Gitea Version ***1.11.0-rc2***
+
+## How to use:
+1. Find your gitea custom directory path in ***Site Administration > Configuration > Custom File Root Path***.
+2. Create directories: ***templates*** and ***public/css*** within the directory, if it does not already exist. But please empty any previous files as they may create a conflict or unexpected behaviour.
+3. Clone then Copy/Move files from this repo into the custom directory location.
+4. Add folowing lines to your gitea config:
+```ini
+[ui]
+THEMES = gitea,arc-green,matrix
+DEFAULT_THEME = matrix
+```
+5. Restart your Gitea Service and you are ready to go.
+### Welcome to the matrix!
+
+### Special Notes:
+ - A user can still change the theme settings. 
+
+
+
+ 
diff --git a/preview/explore.png b/preview/explore.png
new file mode 100644
index 0000000..f0eefe1
Binary files /dev/null and b/preview/explore.png differ
diff --git a/preview/file.png b/preview/file.png
new file mode 100644
index 0000000..38bbf48
Binary files /dev/null and b/preview/file.png differ
diff --git a/preview/homepage.png b/preview/homepage.png
new file mode 100644
index 0000000..9a3093d
Binary files /dev/null and b/preview/homepage.png differ
diff --git a/preview/login.png b/preview/login.png
new file mode 100644
index 0000000..47dc33f
Binary files /dev/null and b/preview/login.png differ
diff --git a/preview/markdowneditor.png b/preview/markdowneditor.png
new file mode 100644
index 0000000..f42c098
Binary files /dev/null and b/preview/markdowneditor.png differ
diff --git a/preview/profilepage.png b/preview/profilepage.png
new file mode 100644
index 0000000..d9a9ea8
Binary files /dev/null and b/preview/profilepage.png differ
diff --git a/preview/repopage.png b/preview/repopage.png
new file mode 100644
index 0000000..e4fc48a
Binary files /dev/null and b/preview/repopage.png differ
diff --git a/preview/settingpage.png b/preview/settingpage.png
new file mode 100644
index 0000000..b16612e
Binary files /dev/null and b/preview/settingpage.png differ
diff --git a/preview/signedhomepage.png b/preview/signedhomepage.png
new file mode 100644
index 0000000..05e0959
Binary files /dev/null and b/preview/signedhomepage.png differ