Add XCUITest authoring docs and reusable prompt template

This commit is contained in:
Trey t
2026-02-18 09:00:28 -06:00
parent 56ac783219
commit b58dfd5093
6 changed files with 262 additions and 29 deletions

30
Tests iOS/README.md Normal file
View File

@@ -0,0 +1,30 @@
# Tests iOS README
## Purpose
`Tests iOS/` contains XCTest-based UI tests for the iOS app.
## Start Here Before Adding Tests
1. Read `/Users/treyt/Desktop/code/Feels/docs/XCUITest-Authoring.md`.
2. Reuse `BaseUITestCase` and helpers in `Helpers/`.
3. Reuse screen objects in `Screens/` before writing inline query logic.
## Required Pattern
- Test class inherits `BaseUITestCase`.
- Selectors use `UITestID` / accessibility identifiers first.
- Waiting/tapping uses helper methods (`tapWhenReady`, `waitForDisappearance`, etc).
- New app interactions get IDs in `/Users/treyt/Desktop/code/Feels/Shared/AccessibilityIdentifiers.swift`.
## Anti-Patterns
- `sleep(...)`
- Selector logic based only on localized labels
- Duplicating navigation logic instead of using `Screens/*`
## Useful Paths
- `/Users/treyt/Desktop/code/Feels/Tests iOS/Helpers/BaseUITestCase.swift`
- `/Users/treyt/Desktop/code/Feels/Tests iOS/Helpers/WaitHelpers.swift`
- `/Users/treyt/Desktop/code/Feels/docs/templates/XCUITestSuiteTemplate.swift`