From ce06f336e20204c4d866d0d3f1d0729fe1b3a2c0 Mon Sep 17 00:00:00 2001
From: Aly Raffauf <aly@aly.codes>
Date: Fri, 31 Jul 2026 11:56:42 -0400
Subject: [PATCH] document homebrew tap

---
 README.md                          | 10 +++++++++-
 website/src/content/docs/index.mdx | 14 ++++++++++----
 2 files changed, 19 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 1f79396..360575d 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,15 @@
 
 ## Installation
 
-### With Nix
+### Homebrew (stable, recommended, macOS+Linux)
+
+```bash
+brew tap alyraffauf/tap
+brew trust alyraffauf/tap
+brew install alyraffauf/tap/tg
+```
+
+### With Nix (latest dev release)
 
 ```bash
 nix profile add github:alyraffauf/tg
diff --git a/website/src/content/docs/index.mdx b/website/src/content/docs/index.mdx
index fda5a69..dc33da4 100644
--- a/website/src/content/docs/index.mdx
+++ b/website/src/content/docs/index.mdx
@@ -19,11 +19,17 @@ import { Card, CardGrid, LinkCard } from "@astrojs/starlight/components";
 ## Install
 
 <CardGrid>
-  <Card title="Nix" icon="nix">
-    ```bash nix profile add github:alyraffauf/tg ```
+  <Card title="Homebrew (stable)" icon="homebrew">
+    ```bash
+      brew tap alyraffauf/tap
+      brew trust alyraffauf/tap
+      brew install alyraffauf/tap/tg
+    ```
   </Card>
-  <Card title="From source" icon="download">
-    ```bash go install github.com/alyraffauf/tg/cmd/tg@latest ```
+  <Card title="Nix (development)" icon="nix">
+    ```bash
+      nix profile add github:alyraffauf/tg
+    ```
   </Card>
 </CardGrid>
 
-- 
2.51.2