shipyard

Build goop for Mac OS X 10.9 Mavericks.

Features: yes. Whatever helps native builds to succeed and cross builds to match.

Install (once)

Install shipyard from the pkg. Download it from the latest release and install it:

gh release download -R ModernMavericks/shipyard --pattern '*.pkg'
sudo installer -pkg mavericks-shipyard-*.pkg -target /

Everything lands in /usr/local/mavericks-shipyard — one prefix holding CMake, the shipyard modules and the shell scripts — and three commands appear on your PATH:

/usr/local/bin/shipyard-cmake
/usr/local/bin/shipyard-ctest
/usr/local/bin/shipyard-cpack

Configure your projects with shipyard-cmake. It is a real CMake (4.4.3) that finds shipyard in its own prefix, so there is nothing to register and no search path to set. Any other cmake is refused at configure time, by name — MavericksShipyardConfig.cmake says so rather than half-working. There is no longer a "install shipyard first and cmake afterwards" order to get right: the pkg brings its own.

The pkg also keeps itself current: its updater checks daily and installs each new release. The same pkg works on Intel, on Apple Silicon and on 10.9.

GUI tools that want a CMake executable (CLion, VS Code's CMake Tools, Xcode wrappers) should be pointed at /usr/local/bin/shipyard-cmake. The shared presets live at /usr/local/mavericks-shipyard/share/cmake/MavericksShipyard/mavericks-presets.json.

One thing shipyard-cmake cannot do: HTTPS from inside CMake. file(DOWNLOAD https://…) and FetchContent over HTTPS fail with "Unsupported protocol" — deliberately, and loudly rather than fragilely. shipyard-cmake is built with CMAKE_USE_SYSTEM_LIBRARIES=0 so it links nothing from the build host; CMake's own bundled curl has no macOS TLS backend without OpenSSL, and 10.9's system libcurl (7.30) is too old for CMake 4.4 to build against. Since this is the cmake the family is now required to use, the limitation is everyone's: fetch with the shipyard helpers instead, pinned and integrity-checked in a way file(DOWNLOAD) never was —

sh "$SHIPYARD_SCRIPTS/mavericks_fetch.sh"  # a tarball, verified against a pinned SHA-256
sh "$SHIPYARD_SCRIPTS/clone_pinned.sh"     # a git source, pinned to a digest

Nothing in the org used CMake-level downloads, so nothing broke; if you are porting something that does, that is the substitution to make.

If you have a machine that ran an older shipyard, rm -rf ~/.cmake/packages/MavericksShipyard once. Nothing reads it any more.

Developing shipyard itself

--install is for working on shipyard, not for consuming it. Build and install into a prefix of your own:

shipyard-cmake -S . -B build
shipyard-cmake --install build --prefix "$HOME/.local/opt/shipyard-dev"

Then point a consumer at the dev copy for one configure, without disturbing the installed pkg:

CMAKE_PREFIX_PATH="$HOME/.local/opt/shipyard-dev" shipyard-cmake -S . -B build

CMAKE_PREFIX_PATH is searched before shipyard-cmake's own prefix, so the override is explicit, scoped to the command that asks for it, and gone the moment you stop asking.

Use

In your CMakeLists.txt:

project(foo LANGUAGES C OBJC)

find_package(MavericksShipyard REQUIRED)
include(Mavericks)

add_executable(foo ...)
mavericks_assert_binary_compatible(foo)

In your CMakePresets.json:

{
  "version": 6,
  "include": ["/usr/local/mavericks-shipyard/share/cmake/MavericksShipyard/mavericks-presets.json"],
  "configurePresets": [
    { "name": "native", "inherits": "mavericks-native" },
    { "name": "cross",  "inherits": "mavericks-cross"  }
  ]
}

In your .github/workflows/*.yml (if applicable):

- uses: ModernMavericks/shipyard/.github/actions/install@v1

Then build, and test:

shipyard-cmake --preset native    # on Mavericks
shipyard-cmake --preset cross     # on Tahoe
shipyard-ctest --preset native
shipyard-cpack --preset native    # where the product packages with CPack

Plain cmake is refused: find_package(MavericksShipyard) fails with a message naming shipyard-cmake, rather than configuring against a CMake that cannot target 10.9.

Sparkle

Configure a keypair with ed25519.

In your CMakeLists.txt:

include(MavericksSparkle)
mavericks_add_updater_app(
  NAME          FooUpdater
  BUNDLE_ID     com.example.FooUpdater
  FEED_URL      https://github.com/you/foo/releases/latest/download/appcast.xml
  ICON          updater/foo.icns
  CONFIRM_TITLE "Foo updated"
  CONFIRM_BODY  "Foo was updated in the background."
)

Conventions for Claude Code

The family's conventions ship as the modernmavericks Claude Code plugin, from this repo's marketplace. A product repo's checked-in .claude/settings.json registers the marketplace and enables the plugin, but that alone installs nothing. Install it once, for every family repo:

claude plugin install modernmavericks@modernmavericks --scope user

then turn on auto-update in /plugin → Marketplaces → modernmavericks. The plugin carries no version, so every push to main is an update.