Brewfile Bundles and Installation Workflows#
Automated Brewfile Validation and Installation in Bluefin#
Bluefin now validates all Brewfiles in the /brew directory using a dedicated GitHub Actions workflow. This workflow runs on every pull request or push that modifies files in /brew, using brew bundle check to ensure each Brewfile is valid before merging. If any Brewfile fails validation, the workflow blocks the merge and provides clear feedback on which files failed. The workflow also installs dependencies from each Brewfile using brew bundle install --file, ensuring that all bundles are installable and up-to-date in CI environments. This process relies on the official Homebrew GitHub Action and is future-proofed to automatically validate any new Brewfiles added to the directory. See PR #3432 and PR #3443 for implementation details.
New and Updated Brewfile Bundles#
Bluefin and Project Bluefin Common provide a growing set of curated Brewfile bundles for streamlined developer and desktop workflows. Notable bundles include:
| Bundle Name | Description | Location/Reference |
|---|---|---|
| bluefin-ai.Brewfile | AI tools (e.g., aichat, block-goose-cli, clio, codex, gemini-cli, mods) | bluefin-ai.Brewfile |
| bluefin-cli.Brewfile | CLI utilities (e.g., atuin, bat, bbrew, chezmoi, direnv, eza, gh, starship, yq, zoxide) | bluefin-cli.Brewfile |
| bluefin-fonts.Brewfile | Developer fonts (e.g., Caskaydia Mono, Droid Sans Mono, Fira Code) | bluefin-fonts.Brewfile |
| bluefin-k8s.Brewfile | Kubernetes tools (e.g., cdk8s, k0sctl, k3sup, kind, helm, kubectl, k9s, syft) | bluefin-k8s.Brewfile |
| full-desktop.Brewfile | GNOME Circle and community Flatpaks for a full desktop experience | full-desktop.Brewfile |
| fonts.Brewfile | Additional monospace fonts for development | fonts.Brewfile |
| cli.Brewfile | CLI tools and utilities | cli.Brewfile |
| ai-tools.Brewfile | AI and machine learning tools (updated taps/casks, e.g., claude-code, copilot-cli as cask) | ai-tools.Brewfile |
| cncf.Brewfile | CNCF and cloud-native tools (see below) | cncf.Brewfile |
| k8s-tools.Brewfile | Kubernetes tools | k8s-tools.Brewfile |
| ide.Brewfile | Integrated development environments (now includes Antigravity IDE) | ide.Brewfile |
| experimental-ide.Brewfile | Experimental and preview IDEs (see below) | experimental-ide.Brewfile |
| artwork.Brewfile | Design and artwork applications (now includes bluefin-wallpapers) | artwork.Brewfile |
Install any bundle using:
ujust bbrew
Select the desired bundle from the menu. The ujust bbrew command now displays a loading message to set expectations for longer load times when browsing bundles "Note: Some of these take a while to load, we'll keep working on it.".
IDE and Experimental IDE Bundles#
The ide.Brewfile provides a curated set of IDEs and editors, including Visual Studio Code, VSCodium, JetBrains Toolbox, Neovim, Micro, Helix, Devcontainer CLI, and now Antigravity (officially supported from the main tap). The experimental-ide.Brewfile adds preview and experimental IDEs such as Cursor and JetBrains IDEs sourced from the experimental tap. Both are installable via ujust bbrew "experimental-ide.Brewfile".
For the latest list of supported IDEs and editors, see the ide.Brewfile. For preview/experimental IDEs, see the experimental-ide.Brewfile.
CNCF and Cloud-Native Bundle#
The cncf.Brewfile has been significantly expanded with new taps for CNCF projects, tap-qualified formulas, and comments for manual installation where Homebrew formulas are unavailable. It now includes Flatpak entries for graphical tools like Headlamp, OpenLens, and Podman Desktop. Several formulas were updated for accuracy (e.g., crossplane-cli renamed to crossplane). See the cncf.Brewfile for the full list and usage notes "CNCF Brewfile update".
Full GNOME Desktop Bundle#
The full-desktop.Brewfile offers a comprehensive selection of GNOME Circle and community Flatpak applications for a complete desktop experience. This replaces the previous flatpak-extras concept; all additional GNOME and community apps are now managed through this Brewfile. See full-desktop.Brewfile for details "full-desktop.Brewfile".
Homebrew and Flatpak Integration#
All curated bundles leverage Homebrew's Flatpak support, allowing seamless installation of both CLI tools and graphical applications. For more on Homebrew's Flatpak integration, see the upstream documentation.
Bluefin-LTS: NVIDIA Driver Pinning and Common Container Integration#
Bluefin-LTS now pins all NVIDIA userspace package versions to match the kernel module version extracted from kmod-nvidia, ensuring driver consistency and build reliability. The build process integrates the projectbluefin/common container, dynamically fetching the image digest and using it as a build argument. Documentation and build scripts have been updated for clarity, including safer installation paths for just, improved override directory structures, and simplified post-package installation scripts. See PR #893, PR #890, and PR #894.
Brewfile Validation Workflows#
Both Bluefin and Project Bluefin Common now use robust CI workflows to validate Brewfiles. These workflows check syntax, confirm package existence, and run parallel checks on formulas and casks, providing clear reporting and blocking invalid bundles from merging. See Bluefin PR #3432 and Common PR #64.
Deprecated and Removed Features#
The install-system-flatpaks-extra recipe was removed because it referenced a non-existent file. Users should now use ujust bbrew for installing additional applications beyond the default system Flatpaks "Removal of flatpak-extras".
Homebrew Tap#
The @ublue-os/homebrew-tap repository now includes Antigravity IDE as a first-class cask, available directly from the main tap. Users can install Antigravity without enabling the experimental tap. See the Antigravity cask definition for details.
No other major changes impacting Brewfile bundles, installation workflows, or curated app selections were found in recent updates to the tap.
