# google/EarlGrey

:tea: iOS UI Automation Test Framework

Repository: https://github.com/google/EarlGrey
Canonical: https://ross.abutalabs.com/products/earlgrey
Homepage: http://google.github.io/EarlGrey/
Language: Objective-C
License: Apache-2.0
License Family: permissive
Topics: earlgrey, ios-automation, ui-automated-tests, ios, test-framework, testing-tools, automation, ios-device, ios-development, ios-test
Last push: 2026-08-26T23:01:08+00:00

## Health v2 (maintenance only)
Score: 67/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 8, longevity 100
- inputs: {"age_days": 3863, "days_push": 7, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5691, forks 736 (observed 2026-08-28T04:09:27.970066+00:00)

## What it is
EarlGrey is Google's native iOS UI automation test framework that lets developers write clear, concise UI tests with automatic synchronization against the UI, network requests, and queues. Version 1.0 is deprecated in favor of EarlGrey 2.0, which integrates with XCUITest.

## Use cases
- write automated UI tests for iOS apps
- make flaky iOS UI tests more stable and repeatable
- synchronize tests with network requests and UI state
- run iOS UI tests from Xcode or xcodebuild
- automate iOS app interaction testing

## When to choose
- you need stable, synchronized native iOS UI tests
- you want a Google-maintained alternative to plain XCUITest
- your team tests iOS apps in Objective-C or Swift

## When to avoid
- you are starting a new project and should use EarlGrey 2.0 instead
- you need to test Android apps
- you rely on EarlGrey 1.0 with iOS 13+, since it is no longer maintained

## Facets
- artifact type: framework
- maturity: maintenance
- function: testing, e2e-testing
- domain: testing, mobile-development
- platform: cpp
- tags: ui-automation, xctest, objective-c, ios-testing, ui-synchronization, automation, ios, swift

## Member repositories
- google/EarlGrey (main) score 67

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:27.970066+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:53:44.150704+00:00, confidence not recorded.
  - readme: https://github.com/google/EarlGrey (fetched 2026-08-28T04:09:27.970066+00:00, sha 7e7c1382938e)
  - homepage: http://google.github.io/EarlGrey/ (fetched 2026-08-29T08:49:08.765729+00:00, sha ddc9c2f51a02)
- Data as of 2026-08-30T08:39:29.467469+00:00.