Build

Local package checks, binary rebuild flow, theme generation, and GitHub Pages publishing setup.

Package checks

swift build
swift test
./Script/test.sh

./Script/test.sh verifies the package across macOS, iOS, iOS Simulator, and Mac Catalyst destinations.

Rebuild libghostty

./Script/build.sh

./Script/build.sh \
  --platforms macos,ios \
  --source /path/to/ghostty \
  --skip-tests

The build scripts apply patches from Patches/ghostty, build target libraries with Zig, merge them into GhosttyKit.xcframework, and update release artifacts.

Release manifest

./Script/build-manifest.sh

When products, targets, or binary metadata change, keep Package.swift, Package.local.swift, and Package.swift.template aligned.

Theme generation

./Script/generate-themes.sh

This regenerates Sources/GhosttyTheme/Themes from iTerm2-Color-Schemes.

GitHub Pages

The documentation site is a static site under docs/, matching the SSHKit Pages layout. .github/workflows/pages.yml publishes it with GitHub Actions on every main push that changes docs. docs/.nojekyll keeps GitHub Pages serving files exactly as written.

Local preview

cd docs
python3 -m http.server 8000