1 files changed, 67 insertions, 0 deletions
diff --git a/hypr/catppuccin/README.md b/hypr/catppuccin/README.md
new file mode 100644
index 0000000..830c369
--- /dev/null
+++ b/hypr/catppuccin/README.md
@@ -0,0 +1,67 @@
+<h3 align="center">
+	<img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/logos/exports/1544x1544_circle.png" width="100" alt="Logo"/><br/>
+	<img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/misc/transparent.png" height="30" width="0px"/>
+	Catppuccin for <a href="https://github.com/hyprwm/hyprland">Hyprland</a>
+	<img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/misc/transparent.png" height="30" width="0px"/>
+</h3>
+
+<p align="center">
+	<a href="https://github.com/catppuccin/hyprland/stargazers"><img src="https://img.shields.io/github/stars/catppuccin/hyprland?colorA=363a4f&colorB=b7bdf8&style=for-the-badge"></a>
+	<a href="https://github.com/catppuccin/hyprland/issues"><img src="https://img.shields.io/github/issues/catppuccin/hyprland?colorA=363a4f&colorB=f5a97f&style=for-the-badge"></a>
+	<a href="https://github.com/catppuccin/hyprland/contributors"><img src="https://img.shields.io/github/contributors/catppuccin/hyprland?colorA=363a4f&colorB=a6da95&style=for-the-badge"></a>
+</p>
+
+<p align="center">
+  <img src="assets/res.webp"/>
+</p>
+
+## Previews
+
+<details>
+<summary>🌻 Latte</summary>
+<img src="assets/latte.webp"/>
+</details>
+<details>
+<summary>🪴 Frappé</summary>
+<img src="assets/frappe.webp"/>
+</details>
+<details>
+<summary>🌺 Macchiato</summary>
+<img src="assets/macchiato.webp"/>
+</details>
+<details>
+<summary>🌿 Mocha</summary>
+<img src="assets/mocha.webp"/>
+</details>
+
+## Usage
+
+1. Download the file with your desired flavour e.g. `mocha.conf` (to be found in the [release](https://github.com/catppuccin/hyprland/releases/latest) or after cloning the repository in `themes/`)
+2. Copy it into your hyprland config e.g. `~/.config/hypr/`
+3. Include the file at the top of your `hyprland.conf`
+   - `source=~/.config/hypr/mocha.conf`
+4. When using the non-alpha colors, use `$COLOR` e.g. `$base`
+5. When using the alpha colors use something like `rgba($COLORAlpha<transparency>)` e.g. `rgba($surface0Alphaee)`
+
+## 🙋 FAQ
+
+-	Q: **_"Hyprland doesn't work with the colors"_**\
+	A: Make sure you included the file in the right place and you are using `$COLOR`
+
+## 💝 Thanks to
+
+- [rubyowo](https://github.com/rubyowo)
+
+&nbsp;
+
+<p align="center">
+	<img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/footers/gray0_ctp_on_line.svg?sanitize=true" />
+</p>
+
+<p align="center">
+	Copyright &copy; 2021-present <a href="https://github.com/catppuccin" target="_blank">Catppuccin Org</a>
+</p>
+
+<p align="center">
+	<a href="https://github.com/catppuccin/catppuccin/blob/main/LICENSE"><img src="https://img.shields.io/static/v1.svg?style=for-the-badge&label=License&message=MIT&logoColor=d9e0ee&colorA=363a4f&colorB=b7bdf8"/></a>
+</p>