Skip to content

HOMEBREW.md

Latest commit

 

History

History
172 lines (113 loc) · 3.34 KB

HOMEBREW.md

File metadata and controls

172 lines (113 loc) · 3.34 KB
Raw

Homebrew Distribution

Current state

Pausa is already installable via a repo tap:

brew tap yuseferi/pausa https://github.com/yuseferi/pausa
brew install --cask pausa

That is the current working path.

Pausa now ships both:

  • Apple Silicon (arm64)
  • Intel (amd64)

so the repo-tap cask works on both modern Mac architectures.

For local release prep, you can use:

scripts/release.sh 1.0.2

or:

make release VERSION=1.0.2

This now builds both zip assets and automatically rewrites Casks/pausa.rb with the new version and SHA256 values.

The repo also uses semantic-release on main:

  • conventional commits determine the next version
  • semantic-release creates the tag and GitHub release
  • the release workflow reacts to the published release and uploads the dual-arch app zips

Goal: one-line install

To make this work:

brew install --cask pausa

the cask must be merged into Homebrew/homebrew-cask.

Current blockers to upstream inclusion

1. App bundle is unsigned

At the moment:

codesign -dv --verbose=4 build/bin/pausa.app

reports that the app is not signed.

For an official Homebrew cask, signing is strongly preferred and in practice often expected for a GUI app distributed as a .app bundle.

Recommended fix:

  • Developer ID Application signing
  • notarization with Apple
  • staple the ticket to the final .app

2. Release is dual-arch, but still unsigned

The release workflow now publishes both:

pausa-<version>-arm64-macos.zip
pausa-<version>-amd64-macos.zip

and the cask selects the correct asset with on_arm / on_intel.

This removes the architecture blocker for official inclusion.

The main remaining blocker is still signing/notarization.

3. Ongoing cask maintenance

For each release, the cask must be updated with:

  • new version
  • new sha256
  • release asset URL (if naming changes)

The current workflow automates building and uploading the release asset, but does not yet auto-open a PR against homebrew-cask.

Current cask file

The repo contains a cask candidate at:

Casks/pausa.rb

It is intentionally shaped close to the Homebrew style already:

  • lower-case token
  • name, desc, homepage
  • on_arm / on_intel architecture-specific assets
  • app "pausa.app"
  • zap stanza

Suggested path to official inclusion

  1. Sign and notarize the app
  2. Produce either:
    • dual-arch releases, or
    • a universal build
  3. Keep release assets stable and predictable
  4. Copy Casks/pausa.rb into a branch of Homebrew/homebrew-cask
  5. Run Homebrew audit from that repo
  6. Open PR to Homebrew/homebrew-cask

Example upstream cask PR draft

Title:

Add pausa

Body:

## Description

Adds Pausa, a native-feeling macOS break reminder for developers and
knowledge workers.

## App details

- homepage: https://github.com/yuseferi/pausa
- download: GitHub Releases
- package: signed / notarized .app bundle zip

## Notes

- overlays support fullscreen-app Spaces
- menu-bar app with native notifications
- busy-aware auto-pause for meetings and media

If you only want the user-facing one-liner

The only durable way to get:

brew install --cask pausa

is to land in the official Homebrew cask repo.

Until then, the repo-tap install remains the realistic path.