Getting Started
Migrating from fastlane
Lane-by-lane mapping from fastlane to shipit equivalents.
On this page
Why migrate?
ShipItSwifty replaces a Ruby toolchain with a single Swift binary. No Gemfile, no Bundler, no plugin compatibility matrix — just one CLI you can install via Homebrew or build from source.
Lane-by-lane mapping
| fastlane | shipit |
|---|---|
match | shipit sign sync |
gym | shipit archive + shipit export |
pilot | shipit testflight |
deliver | shipit metadata + shipit upload |
scan | shipit test |
snapshot | shipit screenshot |
frameit | shipit screenshot --frame |
pem | covered by ASC API integration |
produce | covered by ASC API integration |
What you gain
- Single binary — no Ruby, no Bundler, no plugin compatibility matrix
- Native Swift — same language as your app, debuggable with Xcode
- iOS + Android — one CLI for both platforms
- Guided setup —
shipit generatewalks you through config creation interactively - Validation built-in — YAML, metadata, and archive checks before upload
For the full feature set, see the Configuration Reference.
Tool comparison
| Common Tool | ShipItSwifty Equivalent | Notes |
|---|---|---|
| Archive / build | shipit build + shipit archive | Split into distinct steps |
| Test runner | shipit test | JSON structured output |
| Screenshot capture | shipit snapshot | Simulator management built-in |
| App Store upload | shipit upload + shipit metadata | Split metadata from binary upload |
| TestFlight upload | shipit testflight | Full TestFlight management |
| Code signing sync | shipit sign sync | Git/S3 encrypted cert vault |
| Metadata validation | shipit validate metadata | Precheck alias also supported |
| Build number bump | shipit version --bump build | Multiple strategies |
| Version bump | shipit version --bump minor | SemVer support |
| Workflow file | Shipfile.yml workflows | YAML-based, Swift-native |
Next steps
- Quick Start — get running in 5 minutes
- Walkthrough — end-to-end guide including migration tips