Migrating from fastlane

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

Release lane: tagging the released version

A typical fastlane release lane bumps the version, ships, then tags and pushes:

lane :release do
  capture_screenshots
  build_app
  upload_to_app_store(submit_for_review: true)
  increment_version_number(bump_type: "patch")
  commit_version_bump
  add_git_tag(tag: "v#{lane_context[SharedValues::VERSION_NUMBER]}")
  push_to_git_remote
end

The same flow in Shipfile.yml — note that lane_context[SharedValues::VERSION_NUMBER] becomes the {{version}} token, and the tag step is gated by when: "{{version_changed}}" so build-only bumps don't re-tag:

workflows:
  release:
    - action: screenshot
    - action: archive
      options: { configuration: Release, export_method: app-store }
    - action: export
    - action: upload
      options:
        submit_for_review: true
        phased_release: true
    - action: version
      options: { bump: patch }
    # add_git_tag with the bumped version becomes the {{version}} token —
    # no lane_context plumbing. The tag is skipped on build-only bumps.
    - action: git
      options: { operation: commit, commit_message: "chore: release v{{version}}" }
    - action: git
      when: "{{version_changed}}"
      options: { operation: tag, tag_name: "v{{version}}" }
    - action: git
      options: { operation: push, push_tags: true }

shipit generate --goal release scaffolds this commit/tag/push tail automatically for both iOS and Android. See Workflow tokens & step conditions for the full list of reserved tokens.

What you gain

• Single binary — no Ruby, no Bundler, no plugin compatibility matrix
• Native Swift — same language as your app, debuggable with Xcode
• Guided setup — shipit generate walks you through config creation interactively
• Validation built-in — YAML, metadata, and archive checks before upload

Tool comparison

Next steps

• Installation — install and verify your environment
• iOS Quickstart — end-to-end guide from config to TestFlight
• Android Quickstart — set up Gradle builds and Play Store uploads