Skip to content

feat: Homebrew cask in this repository - #14

Merged
tieuanhquoc merged 1 commit into
masterfrom
feat/homebrew-cask
Oct 5, 2026
Merged

tieuanhquoc merged 1 commit into
masterfrom
feat/homebrew-cask

Conversation

@tieuanhquoc

Copy link
Copy Markdown
Collaborator

Summary

Adds a Homebrew cask inside this repo (no separate homebrew-* tap repo):

brew tap nextage-soft/dockz https://github.com/nextage-soft/dockz
brew install --cask nextage-soft/dockz/dockz

Design

  • Casks/dockz.rb tracks the latest release: url …/releases/latest/download/DockZ.dmg, version :latest, sha256 :no_check. Master only changes through PRs, so a per-release version/SHA bump can't be pushed automatically; tracking latest means the cask never needs editing.
  • release.yml attaches a stable-named DockZ.dmg next to DockZ-<version>.dmg (+ .sha256). Release notes now include the Homebrew commands.
  • Cask: Apple Silicon + macOS 15 required; uninstall quit: stops DockZ (clean VM shutdown) before replacing it; caveats cover the un-notarized first launch, brew upgrade --cask --greedy dockz, and that --zap deletes ~/.dockz (all Docker data).

Trade-offs (vs a versioned cask in a separate tap repo)

  • Homebrew doesn't verify a checksum (each release still publishes its SHA-256).
  • Updates need --greedy (or brew reinstall).

Also: README, deployment guide, website install card and CHANGELOG (Unreleased) mention Homebrew. v0.2.1 already has the stable DockZ.dmg asset (checksum-verified copy), so the cask works as soon as this merges.

Test plan

  • ruby -c, workflow YAML parses.
  • Homebrew 7.0.7, local tap of this branch: brew audit --cask --strict → exit 0, no findings; brew info shows arm64 + macOS ≥ 15, DockZ.app, caveats; brew fetch --cask downloads the DMG.
  • releases/latest/download/DockZ.dmg → 200.
  • Not run: brew install (would replace and, on uninstall, quit the DockZ running on the dev Mac).

🤖 Generated with Claude Code

Install with:
  brew tap nextage-soft/dockz https://github.com/nextage-soft/dockz
  brew install --cask nextage-soft/dockz/dockz

The cask lives in Casks/dockz.rb here instead of a separate homebrew-*
tap repo. Because master only changes through PRs, a per-release version
bump can't be automated; the cask therefore tracks
releases/latest/download/DockZ.dmg (`version :latest`, `sha256 :no_check`)
and the Release workflow attaches that stable-named copy of the DMG next to
DockZ-<version>.dmg. Upgrades use `brew upgrade --cask --greedy dockz`;
the per-version SHA-256 stays published on each release.

The cask quits DockZ before uninstalling (clean VM shutdown), requires
Apple Silicon and macOS 15, explains the un-notarized first launch, and
`--zap` removes ~/.dockz (VM disk) plus preferences.

Checked with Homebrew 7.0.7 from a local tap: `brew audit --cask --strict`
passes, `brew info` shows requirements/artifact/caveats, `brew fetch`
downloads the DMG. v0.2.1 now also carries DockZ.dmg (byte-identical,
checksum-verified copy).

README, the deployment guide, the website and release notes show the
Homebrew commands; CHANGELOG notes it under Unreleased.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@cloudflare-workers-and-pages

Copy link
Copy Markdown
Contributor

Deploying dockz with  Cloudflare Pages  Cloudflare Pages

Latest commit: aa6c0b5
Status: ✅  Deploy successful!
Preview URL: https://68b44711.dockz.pages.dev
Branch Preview URL: https://feat-homebrew-cask.dockz.pages.dev

View logs

@tieuanhquoc
tieuanhquoc merged commit 648ac54 into master Oct 5, 2026
3 checks passed
@tieuanhquoc
tieuanhquoc deleted the feat/homebrew-cask branch October 5, 2026 10:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant