explaingit

fastlane/watchbuild

Analysis updated 2026-07-05 · repo last pushed 2021-10-26

328RubyAudience · developerComplexity · 2/5DormantSetup · easy

TLDR

A command-line tool that notifies you on Mac or Slack when Apple finishes processing your iOS app upload, so you stop refreshing the App Store Connect web page.

Mindmap

mindmap
  root((repo))
    What it does
      Notifies when build ready
      Polls App Store Connect
      macOS and Slack alerts
    How it works
      Runs from terminal
      One command to start
      Clickable notification
    Use cases
      TestFlight beta releases
      App review submissions
      Team release workflows
    Audience
      iOS developers
      Solo developers
      Dev teams
    Security
      Local keychain storage
      Runs on your machine
      No plain text files
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Get a Mac notification when your uploaded iOS build is ready for TestFlight or review.

USE CASE 2

Route build-ready alerts to a Slack channel for your team.

USE CASE 3

Click the notification to jump straight to the finished build in App Store Connect.

What is it built with?

RubymacOSApp Store Connect APISlack

How does it compare?

fastlane/watchbuildmitchellh/net-ssh-shellmitchellh/virtuoso
Stars3287932
LanguageRubyRubyRuby
Last pushed2021-10-262015-03-272010-12-15
MaintenanceDormantDormantDormant
Setup difficultyeasyeasymoderate
Complexity2/52/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Install via Ruby gem and run a single terminal command with your app bundle ID and Apple ID.

In plain English

WatchBuild is a simple tool that tells you when Apple has finished processing your iOS app upload. When you upload a new app build from Xcode to App Store Connect, Apple runs its own processing step before you can submit the app for review or push it to TestFlight. That processing time is famously unpredictable, it can take anywhere from a few minutes to several hours. Instead of manually refreshing a web page to check, you get a macOS notification the moment the build is ready. The tool runs from your terminal. After a one-time installation, you type a single command and optionally include your app's bundle identifier and your Apple ID username. It then polls App Store Connect in the background, waiting for Apple to finish. Once the build is ready, you get a notification on your Mac that you can click to jump straight to the build in App Store Connect. You can also route notifications to a Slack channel if you prefer. This is aimed at iOS developers and teams who upload app builds and want to move on to other work instead of babysitting the upload. If you are a solo developer submitting updates and want a nudge when it is time to kick off a TestFlight beta, or a team member waiting to push a release through review, this saves you from repeatedly checking back. It is particularly useful given that Apple's processing times have no reliable estimate. Notably, it is a standalone tool, you do not need to adopt the broader fastlane automation suite to use it. Your Apple ID credentials are stored securely in your Mac's local keychain rather than in a plain file, and everything runs locally on your own machine. It is intentionally small in scope: it does not upload builds or distribute them, it just watches and notifies.

Copy-paste prompts

Prompt 1
How do I install WatchBuild and run it to monitor my iOS app build processing on App Store Connect?
Prompt 2
Show me the command to watch a specific app bundle ID with my Apple ID and get a macOS notification when the build is ready.
Prompt 3
How do I configure WatchBuild to send build-ready notifications to a Slack channel instead of macOS?
Prompt 4
Where does WatchBuild store my Apple ID credentials and is it secure to use on my local machine?

Frequently asked questions

What is watchbuild?

A command-line tool that notifies you on Mac or Slack when Apple finishes processing your iOS app upload, so you stop refreshing the App Store Connect web page.

What language is watchbuild written in?

Mainly Ruby. The stack also includes Ruby, macOS, App Store Connect API.

Is watchbuild actively maintained?

Dormant — no commits in 2+ years (last push 2021-10-26).

How hard is watchbuild to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is watchbuild for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.