Ship Kit
Ship Kit
Scripts, agent skills, checklists, and templates for a SwiftUI iOS app, including an app with extensions. Coming soon. Checkout is not open.
What's in it
- Mac gate script (Release build and tests, auto-picks a simulator)
- pbxproj drift check for XcodeGen projects
- Safe build-number bump with dry-run mode
- Archive script, plus an export and TestFlight upload script
- asc.py, an App Store Connect helper for internal groups, testers, and What to Test notes
- Secret scan script
- Agent rules and skills for Cursor and Claude Code (iOS ship gates, TestFlight internal)
- RUNBOOK, TROUBLESHOOTING, and ROLES
- Checklists: Mac gate, QA gate, archive smoke test, upload
- Templates: ship.env, ExportOptions.plist, gate report, and What to Test
Requirements
- A Mac, with Xcode, because the scripts run xcodebuild
- An Apple Developer account
- A SwiftUI iOS app. Apps with extensions are supported.
- An XcodeGen project. The drift check compares the committed project with xcodegen output.
- Apple's latest Program License Agreement, accepted. Preflight reports
PLA_NOT_ACCEPTEDuntil you accept it. - For cloud signing, an App Store Connect API key with the Admin role. Otherwise, sign in to Xcode.
- Cursor or Claude Code if you use the included skills. The runbook is for an agent that can run shell commands.
Install and getting started
Checkout is not open. Join the list from the product page. When checkout opens, you pay on Stripe and Stripe emails a verified download link.
After you have the files, start with the RUNBOOK and point your agent at the included skills for Cursor or Claude Code.
Walkthrough
A dry run on the sample app ShipKitDryRun ran the drift check, the
Mac gate, a build-number bump with --dry-run, and the
archive. That dry run did not run export or upload.
-
Commit the project before the drift check. The check looks at the
committed
.xcodeproj. -
Run the drift check.
On the sample app it printed that the committed project matches xcodegen output.$ scripts/check-pbxproj-drift.sh -
Run the Mac gate before the bump. Pass the commit you just
recorded.
On the sample dry run the gate picked a simulator, ran a Release build and the tests with$ scripts/mac-gate.sh <commit>CODE_SIGNING_ALLOWED=NO, and printedGATE PASS. - Read the maximum build number live. Do this after the gate and before the bump.
-
Bump only after the gate has passed. Use dry-run first.
On the sample app, dry-run reported that it would set$ scripts/bump-build.sh <number> --dry-runCURRENT_PROJECT_VERSIONinproject.ymland then runxcodegen generate. Dry-run does not apply that change. -
Archive the same commit the gate passed.
The sample dry run wrote$ scripts/archive.sh <commit>build/archives/ShipKitDryRun-1.xcarchive. -
Export with the export and TestFlight upload script. The archive
transcript names
export-upload.sh. The sample dry run did not run it.
Configuration
-
The bump script changes
CURRENT_PROJECT_VERSIONinproject.yml, then runs xcodegen. Use--dry-runto see the change without writing it. -
The sample archive invocation passed
DEVELOPMENT_TEAMandPRODUCT_BUNDLE_IDENTIFIERto xcodebuild. -
The kit includes
ship.envandExportOptions.plisttemplates. - Cloud signing needs an App Store Connect API key with the Admin role. If the key is not Admin, sign in to Xcode instead.
- The scripts read keys from your own environment. The kit does not send those keys to NixonMade.
FAQ
- Which apps does it cover?
- SwiftUI iOS apps, including apps with extensions.
- What order do the scripts run in?
- Commit, then the drift check. The gate runs before the bump. Read the maximum build number live before you bump. Archive after that. Export is a separate script and was not part of the sample dry run.
- Does the kit submit to App Store review?
- No. App Store submission is outside this kit.
- What do updates cover?
- Updates cover 1.0.x. A later major version is not included.
- Who is the licence for?
- One developer. No resale. See the terms.
Troubleshooting
- Commit before the drift check. The check compares the committed project with xcodegen output. On the sample app, success was the line that the committed project matches xcodegen output.
- Do not bump before the gate passes.
-
If preflight reports
PLA_NOT_ACCEPTED, accept Apple's latest Program License Agreement, then run the preflight again. - If cloud signing fails because the App Store Connect key is not Admin, sign in to Xcode instead.
The kit also includes TROUBLESHOOTING and the checklists for the Mac gate, the QA gate, the archive smoke test, and upload.
Download again and support
Checkout is not open. When a purchase has a checkout session id, the re-download page opens the download page. For help, email hello@nixonmade.com.