Skip to content

docs: skip the UI tests in the default local test command - #140

Merged
itsjoshpark merged 1 commit into
mainfrom
docs/skip-ui-tests-locally
Aug 22, 2026
Merged

docs: skip the UI tests in the default local test command#140
itsjoshpark merged 1 commit into
mainfrom
docs/skip-ui-tests-locally

Conversation

@itsjoshpark

Copy link
Copy Markdown
Owner

AGENTS.md gave xcodebuild clean analyze test as the command to run, and plain test runs every target in the scheme. Anyone following it — a person or an agent — drove the app through the full UI suite on every change, which needs an unlocked display and takes a couple of minutes.

CI runs the unmodified full test on every PR (.github/workflows/ci.yml:31), so the UI tests keep their coverage. This only changes what gets run locally by default.

Changes

The default command now passes -skip-testing:"Front Row UI Tests", and the UI test command is reframed from "while iterating on them" to the deliberate opt-in:

# The UI tests, which drive the built app and need an unlocked display. CI runs
# them on every PR, so run them here only while iterating on the UI tests
# themselves or when asked to.

-skip-testing rather than -only-testing:"Front Row Tests" so that a future test target is picked up locally without anyone having to remember to update this file.

Testing

Ran the new default command: ** TEST SUCCEEDED **. The full Swift Testing unit suite runs and passes, no app window is launched, and it finishes in roughly 30 seconds instead of two and a half minutes.

Documentation only — no source changes.

The documented build-and-test command ran every target, so agents and
contributors following it drove the app through the full UI suite on
each change. That needs an unlocked display and takes minutes, and CI
already runs those tests on every PR.

The default now skips the UI test target, and the UI test command is
framed as the deliberate opt-in for iterating on those tests.
@itsjoshpark
itsjoshpark merged commit 30d0c82 into main Aug 22, 2026
2 checks passed
@itsjoshpark
itsjoshpark deleted the docs/skip-ui-tests-locally branch August 22, 2026 19:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant