Home

Awesome

<h3 align="center"> <a href="https://github.com/fastlane/fastlane"> <img src="https://raw.githubusercontent.com/fastlane/boarding/master/app/assets/images/fastlane.png" width="100" /> <br /> fastlane </a> </h3> <p align="center"> <a href="https://github.com/fastlane/fastlane/tree/master/deliver">deliver</a> &bull; <a href="https://github.com/fastlane/fastlane/tree/master/snapshot">snapshot</a> &bull; <a href="https://github.com/fastlane/fastlane/tree/master/frameit">frameit</a> &bull; <a href="https://github.com/fastlane/fastlane/tree/master/pem">pem</a> &bull; <a href="https://github.com/fastlane/fastlane/tree/master/sigh">sigh</a> &bull; <a href="https://github.com/fastlane/fastlane/tree/master/produce">produce</a> &bull; <a href="https://github.com/fastlane/fastlane/tree/master/cert">cert</a> &bull; <a href="https://github.com/fastlane/fastlane/tree/master/spaceship">spaceship</a> &bull; <a href="https://github.com/fastlane/fastlane/tree/master/pilot">pilot</a> &bull; <b>boarding</b> &bull; <a href="https://github.com/fastlane/fastlane/tree/master/gym">gym</a> &bull; <a href="https://github.com/fastlane/fastlane/tree/master/scan">scan</a> &bull; <a href="https://github.com/fastlane/fastlane/tree/master/match">match</a> &bull; <a href="https://github.com/fastlane/fastlane/tree/master/precheck">precheck</a> </p>
<p align="center"> <img src="https://raw.githubusercontent.com/fastlane/boarding/master/assets/BoardingHuge.png" width="650"> </p>

Twitter: @FastlaneTools License

Get in contact with the developers on Twitter: @FastlaneTools


<p align="center"> <a href="#whats-boarding">Why?</a> &bull; <a href="#getting-started">Getting Started</a> &bull; <a href="#how-does-this-work">Technical Details</a> &bull; <a href="#customize">Customize</a> &bull; <a href="#update-to-a-new-version">Update</a> </p>
<h5 align="center"><code>boarding</code> is part of <a href="https://fastlane.tools">fastlane</a>: connect all deployment tools into one streamlined workflow.</h5>

What's boarding?

Instantly create a simple signup page for TestFlight beta testers.

Have you ever been to an airport, where you had to ask the manager of the airport if you can board now? Once the manager agrees, you'll be carried from your check-in to your gate into your plane.

Because that's what you do right now as an app developer when you want to add a new tester to your TestFlight app: Open Screenshots

Why don't you have a simple web site you can share with potential testers (e.g. email newsletter, Facebook, Twitter) on which people interested in trying out your new app can just board on their own?

BoardingScreenshot

Thanks to spaceship.airforce (oh well, I really talk a lot about flying :rocket:) it is now possible to automate the boarding process for your TestFlight beta testers.

Example

Take a look at this live example page: boarding.herokuapp.com

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

Getting Started

Assuming you already have a Heroku account follow those steps:

Assuming you already have an Azure account follow those steps:

boarding does all kinds of magic for you, like fetching the app name and app icon.

Heroku is free to use for the standard machine. If you need a Heroku account, ask your back-end team if you already have a company account.


SetupGif


If your account is protected using 2-factor author, follow the 2 step verification guide.

Security

To secure your webpage, you only have to set the ITC_TOKEN environment variable to any password.

Available environment variables

Required:

Optional:

Custom Domain

With Heroku you can easily use your own domain, follow this guide.

With Azure you can easily use your own domain, follow this guide.

Alternative Setup Options

How does this work?

boarding is part of fastlane, which helps you automate everything you usually do manually as an iOS developer.

Using spaceship.airforce it is possible to manage testers, builds, metadata, certificates and so much more.

This repository is a simple Rails application with most code in these files:

BoardingOverview

More information about this automation process can be found here.

Customize

If you want to change the design, layout or even add new features:

It is recommended to also store your version in your git repo additionally to Heroku.

Update to a new version

From time to time there will be updates to boarding. There are 2 ways to update your Heroku application:

Recommended: Using the terminal

Using Heroku website

Using Azure website

Managing Azure version

If you installed boarding using the deploy to Azure button, boarding will be deployed in an Azure WebApp for containers. This means that azure is running the docker-version of boarding.

Setting optional parameters in Azure

In order to set the optional parameters for boarding follow these steps:

Troubleshoot boarding on Azure

When you run boarding on Azure, it could happen that you run into an HttpStatus 503 showing Service Unavailable There can be multiple reasons for that:

For further troubleshooting, please got to Azure App Service on Linux FAQ

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

Special thanks

Special thanks to @lee_moonan for designing the awesome logo.

Development Setup

  1. gem install bundler
  2. bundle install
  3. Create a .env.local file with the following contents:
    # Required
    ITC_APP_ID=<your_app_id>
    ITC_USER=<your_email>
    ITC_PASSWORD=<your_password>
    
    # Optional
    FASTLANE_ITC_TEAM_NAME=<your_team_name>
    ITC_APP_TESTER_GROUPS=<your_groups>
    ITC_TOKEN=<your_token>
    GA_PROPERTY_ID=<your_ga_property_id>
    IMPRINT_URL=<your_url>
    
  4. bundle exec rails s

Code of Conduct

Help us keep boarding 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. 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.