Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

github_status plugin

fastlane Plugin Badge

Getting Started

This project is a fastlane plugin. To get started with fastlane-plugin-github_status, add it to your project by running:

fastlane add_plugin github_status

About github_status

Provides the ability to display and act upon GitHub server status as part of your build

Status display

	# Display the status of the GitHub APIs as part of your build

example output

Stop your build preemptively

If you use GitHub as part of your build and release process, it can be important to know that their APIs are having trouble before you start taking release actions.

	# Stop the build if the status of the GitHub APIs is currently at or above a certain level of trouble
	github_status(abort_level: 'major') # 'minor' or 'major'

If you want to see how your build will behave when GitHub returns a particular status, you can temporarily force the plugin to return a particular status value by setting the GITHUB_STATUS_TEST_STATUS environment variable before your run, like:

GITHUB_STATUS_TEST_STATUS=major fastlane your_lane

Retrieve the status for your own use

	# Capture the GitHub APIs status information, and use it however you'd like
	message = github_status
	puts "✅ #{message.body} ✅" if message.status == 'good'


Check out the example Fastfile to see how to use this plugin. Try it by cloning the repo, running fastlane install_plugins and bundle exec fastlane test.

Run tests for this plugin

To run both the tests, and code style validation, run


To automatically fix many of the styling issues, use
rubocop -a

## Issues and Feedback

For any other issues and feedback about this plugin, please submit it to this repository.

## Troubleshooting

If you have trouble using plugins, check out the [Plugins Troubleshooting]( doc in the main `fastlane` repo.

## Using `fastlane` Plugins

For more information about how the `fastlane` plugin system works, check out the [Plugins documentation](

## About `fastlane`

`fastlane` is the easiest way to automate building and releasing your iOS and Android apps. To learn more, check out [](


A fastlane plugin for displaying and acting upon GitHub API status







No packages published