diff --git a/.config/fish/.github/README.md b/.config/fish/.github/README.md
index affa9d51..f5a3a30a 100644
--- a/.config/fish/.github/README.md
+++ b/.config/fish/.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>
+
+Fish is my default shell. I tried zsh in the past but I like the built in options of fish as well as its language and the plugin options.
+
+Talking about plugins, these are the ones I'm currently using:
+
+- [Catppuccin](https://github.com/catppuccin/fish)
+- [Done](https://github.com/franciscolourenco/done)
+- [ssh-agent](https://github.com/danhper/fish-ssh-agent)
+- [fzf.fish](https://github.com/Matt-FTW/fzf.fish)
+- [Abbreviations-Tips](https://github.com/gazorby/fish-abbreviation-tips)
+- [Sudope](https://github.com/oh-my-fish/plugin-sudope)
+- [Puffer-fish](https://github.com/nickeb96/puffer-fish)
+- [Autopair](https://github.com/jorgebucaran/autopair.fish)
+
+The prompt I use is [starship](https://starship.rs/). A minimal, easy to customize and blazingly fast prompt written in **Rust btw** 🦀
+
+There is some completion files for apps that I use. You can check them [here](../completions/).
+
+In term of aliases, I have none. Instead, I use custom functions, but thats just a preference. Be sure to not put your aliases inside you config.fish tho. If you wanna know more about it, check this [article](https://bsago.me/tech-notes/make-fish-start-faster).
+
+Abbreviations are included in [this file](../abbreviations.fish).
+
+Finally, if you want to include some custom variables to export at the start of a session, you can do so by placing theme inside [this file](../user_variables.fish). I have some variables already there to help with the XDG directory standard, fzf options, folders that need to be added into the $PATH, etc.
+
+# :wrench: ‎ <samp>Setup</samp>
+
+### :package: Prompt Installation
+
+Starship can be installed from multiple sources. Make sure to check their [installation guide](https://starship.rs/guide/#%F0%9F%9A%80-installation). Once you have Starship installed, restart your session and enjoy!
+
+### :package: Extensions Installation
+
+To install and manage all the plugins, make sure to install [fisher](https://github.com/jorgebucaran/fisher) in your system; it is going to be our plugin manager. Here's a quick reference guide for installing, updating and removing plugins.
+
+```bash
+# To install all plugins
+fisher list | fisher install
+
+# To install a specific plugin
+fisher install <name-plugin>
+
+# To update all plugins
+fisher update
+
+# To update a specific plugin
+fisher update <name-plugin>
+
+# To remove all plugins
+fisher list | fisher remove
+
+# To remove a specific plugin
+fisher remove <name-plugin>
+```
+
+### :package: Theme Installation
+
+Once you install catppuccin the way I showed before, launch a new session and execute this command:
+
+```bash
+fish_config theme save "Catppuccin <variant-name>"
+```
+
+My variant name is **macchiato**. Close and open a new session to see the changes.
+
+To have the LS_COLORS variable with the right colors, install [vivid](https://github.com/sharkdp/vivid) (The Arch Linux way, check docs for other installations):
+
+```bash
+sudo pacman -S vivid
+```
+
+Restart the session to see the changes.
+
+# :camera: ‎ <samp>Gallery</samp>
+
+| **Shell Prompt**                |
+| ------------------------------- |
+| ![overview-1](./overview-1.png) |
+
+| **Commands and LS_COLORS**      |
+| ------------------------------- |
+| ![overview-2](./overview-2.png) |
diff --git a/.config/fish/.github/overview-1.png b/.config/fish/.github/overview-1.png
new file mode 100644
index 00000000..8ac16da4
Binary files /dev/null and b/.config/fish/.github/overview-1.png differ
diff --git a/.config/fish/.github/overview-2.png b/.config/fish/.github/overview-2.png
new file mode 100644
index 00000000..1fc3caf9
Binary files /dev/null and b/.config/fish/.github/overview-2.png differ