docs: Add experimental instructions for macOS

Author: melizeche

CONTRIBUTING.md

@@ -82,9 +82,23 @@ $ ninja install
 $ meson test
 ```
 
+## MacOS support (experimental)
+Most of the dependencies can be installed via [brew](https://brew.sh)
+```bash
+cd Gameeky
+brew install meson pkg-config libadwaita cmake gtksourceview5 desktop-file-utils gstreamer adwaita-icon-theme
+meson setup _build --prefix=~/.local -Dwebkit=disabled
+cd _build
+ninja install
+cd ..
+GSK_RENDERER=gl ~/.local/bin/dev.tchx84.Gameeky.Launcher
+```
+For more detailed instructions check [this guide](./docs/experimental/macOS/README.md)
+
+
 ## Windows support (experimental)
 
-To run on windows, install [msys2](msys2.org) and follow the instructions to set up a development environment. Once the setup is done, install the following dependencies:
+To run on windows, install [msys2](https://msys2.org) and follow the instructions to set up a development environment. Once the setup is done, install the following dependencies:
 
 ```bash
 $ pacman -Suy

docs/experimental/macOS/README.md

@@ -0,0 +1,88 @@
+# Building and Running Gameeky Launcher
+
+This guide explains how to build and run **Gameeky Launcher** from source using **Meson** and **Ninja**.
+
+---
+
+## 1. Install Dependencies
+
+**macOS (Homebrew):**
+
+```bash
+brew install meson pkg-config libadwaita cmake gtksourceview5 desktop-file-utils gstreamer adwaita-icon-theme
+````
+
+---
+
+## 2. Configure and Build
+
+Create the build directory and configure Meson:
+
+```bash
+meson setup _build --prefix=~/.local -Dwebkit=disabled
+```
+
+Then build and install:
+
+```bash
+cd _build
+ninja install
+```
+
+---
+
+## 3. Run Tests (Optional)
+
+```bash
+meson test
+```
+
+---
+
+## 4. Launch Gameeky
+
+Run the launcher:
+
+```bash
+cd ..
+GSK_RENDERER=gl ~/.local/bin/dev.tchx84.Gameeky.Launcher
+```
+
+If you don't have it already you can add `~/.local/bin` to your `PATH`:
+
+```bash
+export PATH=$PATH:~/.local/bin
+```
+And then run:
+
+```bash
+GSK_RENDERER=gl dev.tchx84.Gameeky.Launcher
+```
+
+> 💡 `GSK_RENDERER=gl` forces GTK to use OpenGL for rendering, instead of Vulkan.
+
+Another option:
+```bash
+export GSK_RENDERER=gl
+./dist/bin/dev.tchx84.Gameeky.Launcher
+```
+
+---
+
+## 5. Install Theme Pack
+
+(Optional) Install the **Freedom Valley** theme pack:
+
+```bash
+mkdir -p ~/Gameeky
+cd ~/Gameeky
+git clone https://github.com/tchx84/FreedomValley.git
+```
+
+---
+
+## 6. Done!
+
+You should now have **Gameeky Launcher** running locally with your chosen theme.
+
+