Documentation
Welcome to Build Mac App 👋
Hey, it's Dmytro. This is everything in the repository: how to make it your product, ship a signed and notarized release, take the first payment, and grow from there. Every page here is the same file you get in docs/, so what you read before buying is what you work with after.
With an agent, you rarely need to read these first: open the repository in Claude Code and run /doctor. It says where the project is and which page (or skill) comes next.
What you need
- A Mac with Xcode and Swift 6, and XcodeGen (
brew install xcodegen). - Node 22 with Corepack; the site pins its pnpm version.
- Nothing else to start. An Apple Developer Program membership is needed for the Developer ID certificate when you release, and a payment provider account when you sell; building and running need neither.
Quick start
# the repository you were invited to
% git clone git@github.com:<owner>/<repo>.git your-app && cd your-app
# make it yours: name, domain, Team ID, provider, what a purchase delivers
% scripts/new-app.sh --name "Your App" --domain your-app.com --team ABCDE12345 --payments creem
# where you are, and the next step
% scripts/doctor.sh
# every offline check and both test suites
% scripts/verify.sh --quick
# the site on localhost:3000
% cd site && pnpm install && pnpm dev
# the app: generate the Xcode project, then open it
% mac/scripts/bootstrap.sh && open mac/App.xcodeproj
Everything passes with nothing configured: no account, no key, no deploy. Variables are added when you want the feature they unlock. Then follow Start a new product, which ends in a check that lists anything the rename missed.
Everything else
Get started
Modules
Reference
From template commit be0532d, copied 2026-09-25.