The easiest way to automate building and releasing your iOS and Android apps
Ruby Objective-C Shell HTML Java Swift
Permalink
Failed to load latest commit information.
cert Update spaceship dependencies (#6485) Oct 10, 2016
credentials_manager [credentials_manager] Version bump (#6493) Oct 11, 2016
danger-device_grid Bump deliver version and update all dependencies (#6429) Oct 6, 2016
deliver [deliver] Version bump (#6487) Oct 10, 2016
fastlane Skip updating docs when environment variables are missing (#6508) Oct 12, 2016
fastlane_core Losen up dependencies of subtools (#6461) Oct 10, 2016
frameit [frameit] Version bump Oct 5, 2016
gym Revise xcbuild-safe.sh to work with CircleCI and rbenv (#6513) Oct 12, 2016
match Update spaceship dependencies (#6485) Oct 10, 2016
pem Update spaceship dependencies (#6485) Oct 10, 2016
pilot Update spaceship dependencies (#6485) Oct 10, 2016
produce Update spaceship dependencies (#6485) Oct 10, 2016
rakelib Verify docs on pull requests and releases (#6475) Oct 10, 2016
scan Update xcpretty dependency (#6510) Oct 11, 2016
screengrab Update version.properties (#6503) Oct 11, 2016
sigh Update spaceship dependencies (#6485) Oct 10, 2016
snapshot Update xcpretty dependency (#6510) Oct 11, 2016
spaceship [spaceship] Version bump (#6492) Oct 11, 2016
supply instanciate -> instantiate (#6304) Sep 27, 2016
watchbuild Update spaceship dependencies (#6485) Oct 10, 2016
.gitignore Add .keys to .gitignore Sep 28, 2016
.hound.yml Switched to fastlane mono repo Mar 7, 2016
.rspec Switched to fastlane mono repo Mar 7, 2016
.rubocop.yml Disable CollectionMethods rubocop preferences (#6162) Sep 16, 2016
CODE_OF_CONDUCT.md Move code of conduct to main repo and update links. Mar 7, 2016
CONTRIBUTING.md [Contributing] Mention fastlane plugins (#5748) Aug 15, 2016
Dangerfile Update Danger, and use scopes for all of the core API calls (#5425) Aug 11, 2016
Gemfile Update Danger, and use scopes for all of the core API calls (#5425) Aug 11, 2016
GitHubLabels.md Add a document describing our GitHub labels Apr 7, 2016
ISSUE_TEMPLATE.md Improve language of Environment section of ISSUE_TEMPLATE Apr 13, 2016
LICENSE Update LICENSE for all repos Mar 7, 2016
PULL_REQUEST_TEMPLATE.md Create PULL_REQUEST_TEMPLATE.md (#6110) Sep 13, 2016
README.md Add more fastlane docs banners to main README (#6450) Oct 7, 2016
Rakefile Add `rake update_dependencies` to automatically update internal depen… Sep 29, 2016
circle.yml remove danger from build steps (#5214) Jun 24, 2016

README.md

fastlane Logo

fastlane

Twitter: @FastlaneTools License Gem Build Status

✨ Check out docs.fastlane.tools on how to get started with fastlane ✨

fastlane is a tool for iOS, Mac, and Android developers to automate tedious tasks like generating screenshots, dealing with provisioning profiles, and releasing your application.

Use a lane to define your process:

lane :beta do
  increment_build_number
  cocoapods
  match
  testflight
  sh "./customScript.sh"
  slack
end

Then to deploy a new 'beta' version of your app just run fastlane beta πŸš€

fastlane
✨ Connect iOS, Mac, and Android build tools into one workflow (both fastlane tools and third party tools)
🚝 Define different deployment lanes for App Store deployment, beta builds, or testing
🚒 Deploy from any computer, including a CI server
πŸ”§ Extend and customise functionality
πŸ’­ Never remember any difficult commands, just fastlane
🎩 Easy setup assistant to get started in a few minutes
βœ‰οΈ Automatically pass on information from one build step to another (e.g. path to the ipa file)
πŸ“ƒ Store everything in Git. Never lookup build commands in Jenkins configs again.
πŸš€ Saves you hours for every app update you release
✏️ Flexible configuration using a fully customisable Fastfile
🚠 Implement a fully working Continuous Delivery process
πŸ‘» Jenkins Integration: Show output directly in test results
πŸ“– Automatically generate Markdown documentation of your lane configurations
🐣 Over 170 built-in integrations available
πŸ’» Support for iOS, Mac, and Android apps
:octocat: Full Git and Mercurial support

Check out the new fastlane docs


Like this tool? Be the first to know about updates and new fastlane tools.

Installation

sudo gem install fastlane --verbose

Make sure you have the latest version of the Xcode command line tools installed:

xcode-select --install

If you experience slow launch times of fastlane, try running:

gem cleanup

System Requirements: fastlane requires macOS or Linux with Ruby 2.0.0 or above

If you'd like to take a look at a project already using fastlane check out fastlane-examples which includes fastlane setups by Wikipedia, Product Hunt, MindNode, and more.

Quick Start

Get started with fastlane within just minutes using the quick start guide:

Available Commands

Typically you'll use fastlane by triggering individual lanes:

fastlane [lane_name]

Other Commands

  • fastlane actions: List all available fastlane actions
  • fastlane action [action_name]: Shows a more detailed description of an action
  • fastlane lanes: Lists all available lanes with description
  • fastlane list: Lists all available lanes without description
  • fastlane new_action: Create a new action (integration) for fastlane

Check out the new fastlane docs


fastlane Toolchain

In addition to fastlane's commands, you also have access to these fastlane tools:

  • deliver: Upload screenshots, metadata, and your app to the App Store
  • supply: Upload your Android app and its metadata to Google Play
  • snapshot: Automate taking localized screenshots of your iOS app on every device
  • screengrab: Automate taking localized screenshots of your Android app on every device
  • frameit: Quickly put your screenshots into the right device frames
  • pem: Automatically generate and renew your push notification profiles
  • sigh: Because you would rather spend your time building stuff than fighting provisioning
  • produce: Create new iOS apps on iTunes Connect and Dev Portal using the command line
  • cert: Automatically create and maintain iOS code signing certificates
  • spaceship: Ruby library to access the Apple Dev Center and iTunes Connect
  • pilot: The best way to manage your TestFlight testers and builds from your terminal
  • boarding: The easiest way to invite your TestFlight beta testers
  • gym: Building your iOS apps has never been easier
  • match: Easily sync your certificates and profiles across your team using Git
  • scan: The easiest way to run tests for your iOS and Mac apps

Need Help?

Please submit an issue on GitHub and provide information about your setup.

Special Thanks

Thanks to all contributors for extending and improving fastlane.

Speakers

Are you giving a talk on fastlane? Great! Let us know so we can help you give the best possible presentation.

Code of Conduct

Help us keep fastlane open and inclusive. Please read and follow our Code of Conduct.

License

This project is licensed under the terms of the MIT license. See the LICENSE file.

This project and all fastlane tools are in no way affiliated with Apple Inc or Google. This project is open source under the MIT license, which means you have full access to the source code and can modify it to fit your own needs. All fastlane tools run on your own computer or server, so your credentials or other sensitive information will never leave your own computer. You are responsible for how you use fastlane tools.