Building from Source

Building from Source

Cadence currently ships as source. The repository does not provide a signed or notarized application.

Requirements

• Apple silicon Mac
• macOS 26 or later
• Xcode 27 or later with a compatible macOS SDK
• Homebrew
• Git

Clone and install tools

git clone https://github.com/QenTerra/cadence.git
cd cadence
brew bundle

The Brewfile installs XcodeGen, SwiftFormat, SwiftLint, and xcbeautify. Cadence has no external runtime package or vendored framework.

Generate the project

xcodegen generate --spec project.yml
open Cadence.xcodeproj

Select the Cadence scheme and run it on My Mac. If Xcode is installed at a non-default path, set DEVELOPER_DIR for the current shell before verification.

Complete local gate

bash scripts/verify.sh
git diff --check

The script regenerates the project, checks SwiftFormat and SwiftLint, builds the app, runs unit and integration tests, validates the bundle signature, and checks compiled app-icon metadata and appearance renditions.

GitHub Actions performs generation and static checks. The hosted macOS runner currently provides Xcode 26.6, so it is not evidence of an Xcode 27 build or test pass.

Do not commit

• .build, DerivedData, or other build output;
• xcuserdata, user schemes, certificates, profiles, keys, or signing exports;
• ~/Music/Cadence.library or imported media;
• screenshots of a real library or personal filesystem paths;
• internal agent notes, prompts, scratch plans, or generated audit artifacts.