From dd08c324aaca162ba435d8860e09369fcbc0b4cc Mon Sep 17 00:00:00 2001
From: Erick Vasquez <123427413+evgongora@users.noreply.github.com>
Date: Thu, 31 Oct 2024 09:32:09 -0600
Subject: [PATCH] [Book] Add homebrew installation page (#82)

* docs: add homebrew installation

Co-authored-by: Dmitry Mirgaleev <35151170+dmirgaleev@users.noreply.github.com>
---
 docs/pages/install/homebrew.md | 43 ++++++++++++++++++++++++++++++++++
 vocs.config.ts                 |  1 +
 2 files changed, 44 insertions(+)
 create mode 100644 docs/pages/install/homebrew.md

diff --git a/docs/pages/install/homebrew.md b/docs/pages/install/homebrew.md
new file mode 100644
index 00000000..27738e02
--- /dev/null
+++ b/docs/pages/install/homebrew.md
@@ -0,0 +1,43 @@
+# Installing Stone Using Homebrew
+
+In this guide, you'll learn how to easily install Stone on your macOS ARM64 system using Homebrew, a package manager for macOS.
+
+## Prerequisites
+Before we get started, make sure you have the following:
+- A macOS ARM64 system.
+- Homebrew installed on your machine. If you haven't set up Homebrew yet you can follow the simple instructions at [brew.sh](https://brew.sh/).
+
+## Installation Steps
+Let’s walk through the steps to install the `stone-prover` package via Homebrew:
+
+1. **Tap the Stone Prover Repository**  
+   First, add the `homebrew-stone-prover` tap to your list of Homebrew repositories:
+   ```bash
+   brew tap dipdup-io/homebrew-stone-prover
+   ```
+   This tap makes it super easy to install the Stone Prover.
+
+2. **Install the stone-prover Package**  
+   Now, let’s install the `stone-prover` package using Homebrew:
+   ```bash
+   brew install stone-prover
+   ```
+   This command will download and install the latest version of Stone on your system. Easy peasy!
+
+## Troubleshooting
+If you run into any bumps along the way during installation or usage, here are some helpful tips:
+
+- **Update Homebrew:**  
+  Make sure your Homebrew installation is up to date:
+  ```bash
+  brew update
+  ```
+
+- **Reinstall the Package:**  
+  If the installation didn’t go as planned, you can try reinstalling:
+  ```bash
+  brew reinstall stone-prover
+  ```
+
+- **Check the Homebrew Tap Repository:**  
+  For more information, to report issues, or to contribute to the formula, feel free to visit the [homebrew-stone-prover](https://github.com/dipdup-io/homebrew-stone-prover) repository.
\ No newline at end of file
diff --git a/vocs.config.ts b/vocs.config.ts
index 202e61f9..03e9f9ce 100644
--- a/vocs.config.ts
+++ b/vocs.config.ts
@@ -17,6 +17,7 @@ export default defineConfig({
         { text: "Static binaries", link: "/install/binaries" },
         { text: "Docker images", link: "/install/docker" },
         { text: "Debian packages", link: "/install/debian" },
+        { text: "Homebrew", link: "/install/homebrew" },
       ],
     },
     {