Adds Homebrew formula

Author: raphaelstolt

.gitattributes

@@ -15,6 +15,7 @@ bin/start-watchman export-ignore
 box.json.dist export-ignore
 CHANGELOG.md export-ignore
 example/ export-ignore
+Formula/ export-ignore
 LICENSE.md export-ignore
 llms.txt export-ignore
 lpv-logo.png export-ignore

CHANGELOG.md

@@ -7,6 +7,9 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
 
 ## [Unreleased]
 
+### Added
+- New `Homebrew` formula and usage documentation. Closes [#45](https://github.com/raphaelstolt/lean-package-validator/issues/45).
+
 ## [v5.3.3] - 2026-01-28
 
 ### Fixed

Formula/lean-package-validator.rb

@@ -0,0 +1,22 @@
+class LeanPackageValidator < Formula
+  desc "A CLI for validating if a project has lean releases"
+  homepage "https://github.com/raphaelstolt/lean-package-validator"
+  url "https://github.com/raphaelstolt/lean-package-validator/archive/refs/tags/v5.3.0.tar.gz"
+  sha256 "23b734dca325751555d55fa301e8663662a074af24ef2005a9278a8b8b8d79c1"
+  license "MIT"
+
+  depends_on "php@8.1" => :build
+  depends_on "composer" => :build
+
+  def install
+    system "composer", "install", "--no-dev", "--optimize-autoloader"
+
+    libexec.install Dir["*"]
+
+    (bin/"lean-package-validator").write_env_script libexec/"bin/lean-package-validator", PATH: "#{Formula["php@8.1"].opt_bin}:$PATH"
+  end
+
+  test do
+    system "#{bin}/lean-package-validator", "--version"
+  end
+end

README.md

@@ -61,6 +61,13 @@ wget --quiet https://github.com/raphaelstolt/lean-package-validator/releases/dow
 mv lean-package-validator.phar /usr/local/bin/lean-package-validator
 ```
 
+The lean package validator also can be installed globally via [Homebrew](https://brew.sh/) on macOS systems:
+
+``` bash
+brew tap raphaelstolt/lean-package-validator
+brew install lean-package-validator
+```
+
 ## Usage
 
 Run the lean package validator CLI within or against a project/micro-package