All documentation

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.

Ship Kit product page

What's in it

Requirements

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.

  1. Commit the project before the drift check. The check looks at the committed .xcodeproj.
  2. Run the drift check.
    $ scripts/check-pbxproj-drift.sh
    On the sample app it printed that the committed project matches xcodegen output.
  3. Run the Mac gate before the bump. Pass the commit you just recorded.
    $ scripts/mac-gate.sh <commit>
    On the sample dry run the gate picked a simulator, ran a Release build and the tests with CODE_SIGNING_ALLOWED=NO, and printed GATE PASS.
  4. Read the maximum build number live. Do this after the gate and before the bump.
  5. Bump only after the gate has passed. Use dry-run first.
    $ scripts/bump-build.sh <number> --dry-run
    On the sample app, dry-run reported that it would set CURRENT_PROJECT_VERSION in project.yml and then run xcodegen generate. Dry-run does not apply that change.
  6. Archive the same commit the gate passed.
    $ scripts/archive.sh <commit>
    The sample dry run wrote build/archives/ShipKitDryRun-1.xcarchive.
  7. Export with the export and TestFlight upload script. The archive transcript names export-upload.sh. The sample dry run did not run it.

Configuration

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

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.