Skip to content

macOS packaging and Homebrew

Build a precompiled Apple Silicon, macOS 12+ app. Homebrew installs the archive; it must not compile Graffitty or Chromium.

Preparing a release

Fetch the pinned DVC assets and install export templates matching the development engine.

bash packaging/homebrew/build-terminal.sh
bash apps/server/chromium/build.sh
godot --headless --editor --path frontends/godot/project --import
godot --headless --path frontends/godot/project --script tools/build_packs.gd
package_dir=$(mktemp -d -t graffitty-package)
python3 packaging/homebrew/package_macos.py --template "$HOME/Library/Application Support/Godot/export_templates/4.7.2.stable/macos.zip" --output "$package_dir/Graffitty.app"
python3 packaging/homebrew/check-package.py "$package_dir/Graffitty.app"
ditto -c -k --sequesterRsrc --keepParent "$package_dir/Graffitty.app" dist/graffitty-macos-arm64.zip
  • Stage outside the repository so Spotlight does not index a second app.
  • Use a new output path.
  • The archive must contain Graffitty.app at its root.
  • The app includes Godot, Chromium and CLI tools.
  • Signing is ad hoc, not notarized. The cask removes quarantine to allow launch.

Validate and install locally

python3 tests/macos_bundle_replacement_e2e.py /path/to/Graffitty.app --evidence /path/to/new-evidence

Before moving the staged bundle into /Applications/Graffitty.app:

  1. Unregister the staged copy with lsregister -u.
  2. Replace the installed copy in place; do not keep a second app.
  3. Save a checkpoint and restart the server.
  4. Verify sessions survived and new panes can open.

check-package.py also verifies the Finder Open in Graffitty service declaration.

Publish the cask

Upload graffitty-macos-arm64.zip to a GitHub release tagged v<version>, then:

python3 packaging/homebrew/prepare-cask.py --version 0.1.0 --archive dist/graffitty-macos-arm64.zip
sh packaging/homebrew/sync-recipes.sh ../homebrew-tap
  • Publish the tap separately; these commands only update local files.
  • Update the version, URL and checksum for every release so Homebrew detects upgrades.
  • Use sync-recipes.sh --check to detect drift.

External worlds

World packs are distributed separately from app updates.

godot --headless --path frontends/godot/project --script tools/build_packs.gd -- --worlds-only

Keep each .pck and matching .json together. See world assets for installation.