eytanbiala / boarding

Because an airport doesn't carry each passenger into the planes manually

fastlane

deliver • snapshot • frameit • PEM • sigh • produce • cert • codes

-------

-------

Get in contact with the developer on Twitter: @KrauseFx

---

Why? • Getting Started • Technical Details • Customize • Update

---

boarding is part of fastlane: connect all deployment tools into one streamlined workflow.

What's boarding?

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?

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

Just click the button, login with your Heroku account, enter your iTunes Connect credentials and you're done!

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:

• 
• Enter your iTunes Connect credentials and the bundle identifier of your app. This will all be stored on your own Heroku instance as environment variables
• Click on View App once the setup is complete and start sharing the URL

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.

Security

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

• You can send your users the link and tell them the password
• You can send them the direct link including the token like this: https://url.com/?token=[password]

Available environment variables

Required:

• ITC_USER iTunes Connect username
• ITC_PASSWORD iTunes Connect password
• ITC_APP_ID The Apple ID or Bundle Identifier of your app

Optional:

• ITC_GROUP_NAME The name of the group the user should be added to. Boarding by default
• ITC_TOKEN Set a password to protect your website from random people signing up

Custom Domain

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

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:

• invite_controller.rb
• invite/index.html.erb

Customize

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

• Install the Heroku toolbelt and heroku login
• Clone your application using heroku clone --app [heroku_app_name]
• cd [heroku_app_name]
• Modify the content, in particular the files that are described above.
• Test it locally by running ITC_USER="email" ITC_... rails s and opening http://127.0.0.1:3000
• Commit the changes
• git push

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

• Install the Heroku toolbelt and heroku login
• Clone your application using heroku clone --app [heroku_app_name]
• cd [heroku_app_name]
• git pull https://github.com/fastlane/boarding
• git push

Using Heroku website

• Delete your application on heroku.com
• Create a new boarding application
• Enter your user credentials again

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

License

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

Contributing

1. Create an issue to start a discussion about your idea
2. Fork it (https://github.com/fastlane/boarding/fork)
3. Create your feature branch (git checkout -b my-new-feature)
4. Commit your changes (git commit -am 'Add some feature')
5. Push to the branch (git push origin my-new-feature)
6. Create a new Pull Request