BrewMate - Homebrew GUI

BrewMate is a GUI application for Homebrew on macOS and Linux. Search, install, upgrade, and uninstall formulae and casks (where Homebrew supports them). You can also browse top downloads and manage brew services.

Includes third party apps + from awesome-brew

• install/uninstall casks
• brew update/upgrade
• list local installed
• top installs
• show logs on install/uninstall
• Linux support (Homebrew / Linuxbrew; formula-primary)
• add 3rd party taps
• handle apps required sudo/pass on install/uninstall

Before you begin, ensure you have met the following requirements:

• macOS or Linux (Ubuntu 22.04+ / Debian-class recommended for Linux)
• Homebrew: Required on both platforms. Install with:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

On Linux, use the official prefix /home/linuxbrew/.linuxbrew when possible (best bottle support). Follow the installer’s “Next steps” to add brew to your PATH.

For running Electron / building from source on Debian/Ubuntu:

sudo apt-get install build-essential procps curl file git \
  libgtk-3-dev libnotify-dev libnss3 libxss1 libasound2

brew install romankurnovskii/BrewMate/brewmate --cask

1. Download the latest DMG file from the releases page.
2. Double-click the DMG file to open it.
3. Drag the BrewMate app to your Applications folder.

Linux release artifacts may be produced with electron-builder (AppImage / .deb). From a clone:

npm install
npm run build:linux

Artifacts land in dist-app/. You can also run in development after npm run build with npm start.

Note: On Linux, Homebrew is formula-primary. Casks are shown when available, but many macOS-only casks will not install. Interactive upgrades use the in-app terminal (external Terminal.app is macOS-only).

1. Navigate to your "Applications" folder.
2. Find the app BrewMate and right-click on it.
3. Select "Open" from the context menu.
4. When the security warning appears, click "Open" to confirm that you want to open the app.
5. The app will now launch.

• macOS 10.15 or later, or
• Linux with Homebrew (Ubuntu 22.04+ recommended)

1. Clone the repository: git clone https://github.com/romankurnovskii/BrewMate.git
2. Install dependencies: npm install
3. Build the app: npm run build
4. For development run npm start or npm run start:dev

Build a version you can run and test on your Mac (direct distribution):

npm run build:mac

This creates a DMG in dist-app/ that you can install and run locally.

npm run build:linux

This creates AppImage and/or .deb packages in dist-app/ (see electron-builder.yml).

Build a version for App Store submission (unsigned universal build):

npm run build:mas

This creates a PKG in dist-app/ for App Store submission.

⚠️ Important: MAS builds cannot be run locally - they're only for App Store submission. If you need to test the app, use build:mac instead.

Before submitting to the App Store:

1. Test locally (on your ARM Mac):

   npm run build:mac
   npm run test:local

2. Build for App Store:

   npm run build:mas

3. Pre-submission validation:

   npm run pre-submit

   This checks architecture, code signing, entitlements, and common rejection reasons.

4. Upload to App Store Connect via Transporter app

See docs/BUILD_TYPES.md and docs/SUBMISSION_CHECKLIST.md for more details.

Builds the app for production with code signing (if certificates are available).

Runs the test suite using Jest.

Runs the app in development mode with live reloading.

BrewMate uses GitHub Actions for automated releases and App Store submission. For this to work, you must configure the following:

• GitHub Repository Secrets

See docs/BUILD_TYPES.md and docs/SUBMISSION_CHECKLIST.md for more details.

BrewMate is licensed under the MIT License. See the LICENSE file for details.