BrewMate - Homebrew GUI
BrewMate is a macOS GUI application that makes it easy to search for, install, and uninstall Homebrew casks. You can also see the top downloaded casks.
Includes third party apps + from awesome-brew
- install/uninstall casks
- brew update/upgrade
- list local installed
- top installs
- show logs on install/uninstall
- add 3rd party taps
- handle apps required sudo/pass on install/uninstall
Before you begin, ensure you have met the following requirements:
- macOS: This package is designed to work on macOS. Ensure you are using a compatible version.
- Homebrew: This package requires Homebrew to be installed on your system. Homebrew is a package manager for macOS that simplifies the installation of software. If you don't have Homebrew installed, you can install it by running the following command in your terminal:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"- Download the latest DMG file from the releases page.
- Double-click the DMG file to open it.
- Drag the BrewMate app to your Applications folder.
In terminal:
brew install romankurnovskii/awesome-brew/brewmate --cask --no-quarantineIn terminal:
brew tap romankurnovskii/awesome-brew
brew update
brew install --cask --no-quarantine brewmate- Navigate to your "Applications" folder.
- Find the app
BrewMateand right-click on it. - Select "Open" from the context menu.
- When the security warning appears, click "Open" to confirm that you want to open the app.
- The app will now launch.
- macOS 10.15 or later.
- Clone the repository:
git clone https://github.com/romankurnovskii/BrewMate.git - Install dependencies:
npm install - Build the app:
npm run build - For development run
npm startornpm run start:dev
BrewMate supports two build types:
Build a version you can run and test on your Mac:
npm run build:macThis creates a DMG in dist-app/mac/ that you can install and run locally.
Build a version for App Store submission:
npm run build:masThis creates a PKG in dist-app/mas-universal/ for App Store submission.
build:mac instead.
Before submitting to the App Store:
-
Test locally (on your ARM Mac):
npm run build:mac npm run test:local
-
Build for App Store:
npm run build:mas
-
Pre-submission validation:
npm run pre-submit
This checks architecture, code signing, entitlements, and common rejection reasons.
-
Upload to App Store Connect via Transporter app
See docs/BUILD_TYPES.md and docs/SUBMISSION_CHECKLIST.md for more details.
Runs the app in the development mode.
The app will reload if you make edits in the electron directory.
You will also see any lint errors in the console.
Builds the app package for production to the dist folder.
Your app is ready to be distributed!
BrewMate is licensed under the MIT License. See the LICENSE file for details.