BrewUI

Homebrew's official macOS GUI: making package management approachable for users who prefer graphical interfaces over Terminal, while maintaining complete transparency about underlying Homebrew operations.

Motivation

Enable CLI-averse users to safely discover, install, update and manage Homebrew packages through a native SwiftUI interface that never hides what Homebrew is doing.

Tech

• Swift with strict concurrency · SwiftUI · Swift Package Manager
• Toolchain and macOS requirements: [Package.swift](Package.swift), [.swift-version](.swift-version) and [Xcode project](Homebrew.xcodeproj/project.pbxproj)
• Data from the brew CLI and the Homebrew JSON API (opens in a new tab)

Adding a language

• Open Homebrew/Localizable.xcstrings, press +, pick the language and translate at least one

string there. macOS only lists a language in the per-app picker under Applications in System Settings when the app bundle ships it, so a language that exists only in a package catalog never loads and scripts/localize verify fails. Adding it also records the language in knownRegions in Homebrew.xcodeproj; commit that.

• Add the language to each package catalog you want to translate and do as much of it as you like.
• Never leave a translation blank. An empty value renders as empty text rather than falling back to

English, so delete the entry instead of clearing it. verify fails on a blank.

• Run scripts/localize verify, then scripts/localize status to see how far the language has got.

Translating a string

• Find the catalog that holds it:

grep -rl "Run Again" Homebrew/Localizable.xcstrings Sources/*/Resources/Localizable.xcstrings.

• Read the comment before translating. It says where the string appears and what each or