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.appat 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:
- Unregister the staged copy with
lsregister -u. - Replace the installed copy in place; do not keep a second app.
- Save a checkpoint and restart the server.
- 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 --checkto detect drift.
External worlds¶
World packs are distributed separately from app updates.
Keep each .pck and matching .json together. See world assets for installation.