diff --git a/.config/browser/.github/README.md b/.config/browser/.github/README.md
index affa9d51..d2bfc3d8 100644
--- a/.config/browser/.github/README.md
+++ b/.config/browser/.github/README.md
@@ -1,3 +1,100 @@
 <div align="center">
-<a href=""><img src="./title.png"></a>
+<a href="#"><img src="./title.png"></a>
+</div>
+
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/palette/macchiato.png" width="90%"/><br>
+
+</div>
+
+<div align="center">
+
+<a href="#herb--about"><img width="190px" src="https://raw.githubusercontent.com/Matt-FTW/dotfiles/main/.github/assets/category-images/dotfiles-about.png"></a>
+<a href="#wrench--setup"><img width="190px" src="https://raw.githubusercontent.com/Matt-FTW/dotfiles/main/.github/assets/category-images/dotfiles-setup.png"></a>
+<a href="#camera--gallery"><img width="190px" src="https://raw.githubusercontent.com/Matt-FTW/dotfiles/main/.github/assets/category-images/dotfiles-gallery.png"></a>
+
+</div>
+
+# :herb: ‎ <samp>About</samp>
+
+The browser I'm using right now is [Floorp](https://floorp.app). It is a fork of Firefox, which adds some functionality I really like such as:
+
+- 🚦 Vertical Tabs
+- 👉 Right Sidebar with Custom Actions
+- 🔒 Strong Privacy Options and Defaults
+- 🔥 Fast as F\*ck
+- 🍿 And much more...
+
+The extensions I'm using are:
+
+- [Improve Youtube](https://github.com/code-charity/youtube)
+- [Bitwarden](https://addons.mozilla.org/en-US/firefox/addon/bitwarden-password-manager/?browser=firefox)
+- [Catppuccin Github Icons](https://github.com/catppuccin/github-file-explorer-icons)
+- [Dark Reader](https://github.com/darkreader/darkreader)
+- [Firefox Color](https://addons.mozilla.org/en-US/firefox/addon/firefox-color/)
+- [I still don't care about cookies](https://github.com/OhMyGuus/I-Still-Dont-Care-About-Cookies)
+- [LibRedirect](https://github.com/libredirect/browser_extension)
+- [New Tab Override](https://addons.mozilla.org/en-US/firefox/addon/new-tab-override/)
+- [Return Youtube Dislikes](https://github.com/Anarios/return-youtube-dislike)
+- [Search by Image](https://github.com/dessant/search-by-image)
+- [Sidebery](https://github.com/mbnuqw/sidebery)
+- [Sponsorblock](https://github.com/ajayyy/SponsorBlock)
+- [Stylus](https://github.com/openst)
+- [SurfingKeys](https://github.com/brookhong/Surfingkeys)
+- [Tab Session Manager](https://github.com/sienori/Tab-Session-Manager)
+- [uBlock Origin](https://github.com/gorhill/uBlock#ublock-origin)
+- [ViolentMonkey](https://github.com/violentmonkey/violentmonkey)
+- [Web Scrobbler](https://github.com/web-scrobbler/web-scrobbler)
+- [Wikiwand](https://www.wikiwand.com/)
+
+# :wrench: ‎ <samp>Setup</samp>
+
+> [!WARNING]
+> Guide is created only for Firefox based browsers.
+
+### :package: Theme Installation
+
+First of all, check your active profile. To do so, type `about:profiles` in your browser toolbar. Open the folder where that profile is located (~/.{browser}/{profileid}/). Now symlink or copy the chrome folder from the configuration to the active profile folder.
+
+**Be sure to change the path to your profile**.
+
+```bash
+# Symlink the folder (Recommended)
+ln -s ~/.config/browser/chrome/ ~/.{browser}/{profileid}/chrome
+
+# Copy the folder
+cp -r ~/.config/browser/chrome/ ~/.{browser}/{profileid}/chrome
+```
+
+Now, to install the colorscheme for your browser make sure to follow [this guide](https://github.com/catppuccin/firefox) and select the **Macchiato** variant and the **Lavender** accent color.
+
+Close all instances of your browser and open it again.
+
+Tada! 🎉 You should now see your theme correctly installed.
+
+### :package: user.js Installation
+
+Just like before, check your active profile. Now copy the user.js file from the configuration to the active profile folder.
+
+```bash
+cp ~/.config/browser/user.js ~/.{browser}/{profileid}/user.js
+```
+
+As before, close all instances of your browser and you should be able to test your new user.js.
+
+### :package: Extensions Installation
+
+Read the extensions list over on [this file](). To import the configurations, check each extensions docs to see how.
+
+# :camera: ‎ <samp>Gallery</samp>
+
+| **Lockscreen**                  |
+| ------------------------------- |
+| ![overview-1](./overview-1.png) |
+
+| **Lockscreen**                  |
+| ------------------------------- |
+| ![overview-2](./overview-2.png) |
+
 </div>
diff --git a/.config/browser/.github/overview-1.png b/.config/browser/.github/overview-1.png
new file mode 100644
index 00000000..62a9c248
Binary files /dev/null and b/.config/browser/.github/overview-1.png differ
diff --git a/.config/browser/.github/overview-2.png b/.config/browser/.github/overview-2.png
new file mode 100644
index 00000000..d0507159
Binary files /dev/null and b/.config/browser/.github/overview-2.png differ