Maestro: 10 golden-path flows for critical user journeys
Cross-platform YAML flows (iOS + Android share the AccessibilityIds test-tag namespace). Covers login, register, residence/task CRUD, completion, join, document upload, theme, deeplink, widget. Run: maestro test .maestro/flows/ Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Trey T
11
.maestro/config.yaml
Normal file
11
.maestro/config.yaml
Normal file
@@ -0,0 +1,11 @@
|
|||||||
|
flows:
|
||||||
|
- flows/01-login.yaml
|
||||||
|
- flows/02-register.yaml
|
||||||
|
- flows/03-create-residence.yaml
|
||||||
|
- flows/04-create-task.yaml
|
||||||
|
- flows/05-complete-task.yaml
|
||||||
|
- flows/06-join-residence.yaml
|
||||||
|
- flows/07-upload-document.yaml
|
||||||
|
- flows/08-theme-switch.yaml
|
||||||
|
- flows/09-notification-deeplink.yaml
|
||||||
|
- flows/10-widget-complete.yaml
|
||||||
26
.maestro/flows/01-login.yaml
Normal file
26
.maestro/flows/01-login.yaml
Normal file
@@ -0,0 +1,26 @@
|
|||||||
|
# Golden path: existing user signs in with email+password and lands on tabs.
|
||||||
|
# Cross-platform — uses AccessibilityIds test tags shared with iOS.
|
||||||
|
appId: com.tt.honeyDue
|
||||||
|
name: Login happy path
|
||||||
|
tags:
|
||||||
|
- smoke
|
||||||
|
- auth
|
||||||
|
---
|
||||||
|
- launchApp:
|
||||||
|
clearState: true
|
||||||
|
- tapOn:
|
||||||
|
id: "Login.UsernameField"
|
||||||
|
- inputText: "testuser@example.com"
|
||||||
|
- tapOn:
|
||||||
|
id: "Login.PasswordField"
|
||||||
|
- inputText: "TestPassword123!"
|
||||||
|
- tapOn:
|
||||||
|
id: "Login.LoginButton"
|
||||||
|
- extendedWaitUntil:
|
||||||
|
visible:
|
||||||
|
id: "TabBar.Tasks"
|
||||||
|
timeout: 15000
|
||||||
|
- assertVisible:
|
||||||
|
id: "TabBar.Tasks"
|
||||||
|
- assertVisible:
|
||||||
|
id: "TabBar.Residences"
|
||||||
31
.maestro/flows/02-register.yaml
Normal file
31
.maestro/flows/02-register.yaml
Normal file
@@ -0,0 +1,31 @@
|
|||||||
|
# Golden path: new user registers and is routed to the verify-email stub.
|
||||||
|
appId: com.tt.honeyDue
|
||||||
|
name: Register happy path
|
||||||
|
tags:
|
||||||
|
- smoke
|
||||||
|
- auth
|
||||||
|
---
|
||||||
|
- launchApp:
|
||||||
|
clearState: true
|
||||||
|
- tapOn:
|
||||||
|
id: "Login.SignUpButton"
|
||||||
|
- tapOn:
|
||||||
|
id: "Register.UsernameField"
|
||||||
|
- inputText: "newuser_maestro"
|
||||||
|
- tapOn:
|
||||||
|
id: "Register.EmailField"
|
||||||
|
- inputText: "new+maestro@example.com"
|
||||||
|
- tapOn:
|
||||||
|
id: "Register.PasswordField"
|
||||||
|
- inputText: "NewPassword123!"
|
||||||
|
- tapOn:
|
||||||
|
id: "Register.ConfirmPasswordField"
|
||||||
|
- inputText: "NewPassword123!"
|
||||||
|
- tapOn:
|
||||||
|
id: "Register.RegisterButton"
|
||||||
|
- extendedWaitUntil:
|
||||||
|
visible:
|
||||||
|
id: "Verification.CodeField"
|
||||||
|
timeout: 15000
|
||||||
|
- assertVisible:
|
||||||
|
id: "Verification.VerifyButton"
|
||||||
39
.maestro/flows/03-create-residence.yaml
Normal file
39
.maestro/flows/03-create-residence.yaml
Normal file
@@ -0,0 +1,39 @@
|
|||||||
|
# Golden path: login → Residences tab → Add → fill form → Save.
|
||||||
|
appId: com.tt.honeyDue
|
||||||
|
name: Create residence
|
||||||
|
tags:
|
||||||
|
- smoke
|
||||||
|
- residence
|
||||||
|
---
|
||||||
|
- runFlow: 01-login.yaml
|
||||||
|
- tapOn:
|
||||||
|
id: "TabBar.Residences"
|
||||||
|
- extendedWaitUntil:
|
||||||
|
visible:
|
||||||
|
id: "Residence.AddButton"
|
||||||
|
timeout: 10000
|
||||||
|
- tapOn:
|
||||||
|
id: "Residence.AddButton"
|
||||||
|
- tapOn:
|
||||||
|
id: "ResidenceForm.NameField"
|
||||||
|
- inputText: "Maestro Test Residence"
|
||||||
|
- tapOn:
|
||||||
|
id: "ResidenceForm.StreetAddressField"
|
||||||
|
- inputText: "123 Main St"
|
||||||
|
- tapOn:
|
||||||
|
id: "ResidenceForm.CityField"
|
||||||
|
- inputText: "Austin"
|
||||||
|
- tapOn:
|
||||||
|
id: "ResidenceForm.StateProvinceField"
|
||||||
|
- inputText: "TX"
|
||||||
|
- tapOn:
|
||||||
|
id: "ResidenceForm.PostalCodeField"
|
||||||
|
- inputText: "78701"
|
||||||
|
- hideKeyboard
|
||||||
|
- tapOn:
|
||||||
|
id: "ResidenceForm.SaveButton"
|
||||||
|
- extendedWaitUntil:
|
||||||
|
visible:
|
||||||
|
id: "Residence.List"
|
||||||
|
timeout: 15000
|
||||||
|
- assertVisible: "Maestro Test Residence"
|
||||||
30
.maestro/flows/04-create-task.yaml
Normal file
30
.maestro/flows/04-create-task.yaml
Normal file
@@ -0,0 +1,30 @@
|
|||||||
|
# Golden path: login → Tasks tab → Add → fill → Save.
|
||||||
|
appId: com.tt.honeyDue
|
||||||
|
name: Create task
|
||||||
|
tags:
|
||||||
|
- smoke
|
||||||
|
- task
|
||||||
|
---
|
||||||
|
- runFlow: 01-login.yaml
|
||||||
|
- tapOn:
|
||||||
|
id: "TabBar.Tasks"
|
||||||
|
- extendedWaitUntil:
|
||||||
|
visible:
|
||||||
|
id: "Task.AddButton"
|
||||||
|
timeout: 10000
|
||||||
|
- tapOn:
|
||||||
|
id: "Task.AddButton"
|
||||||
|
- tapOn:
|
||||||
|
id: "TaskForm.TitleField"
|
||||||
|
- inputText: "Replace HVAC Filter"
|
||||||
|
- tapOn:
|
||||||
|
id: "TaskForm.DescriptionField"
|
||||||
|
- inputText: "Monthly filter replacement"
|
||||||
|
- hideKeyboard
|
||||||
|
- tapOn:
|
||||||
|
id: "TaskForm.SaveButton"
|
||||||
|
- extendedWaitUntil:
|
||||||
|
visible:
|
||||||
|
id: "Task.List"
|
||||||
|
timeout: 15000
|
||||||
|
- assertVisible: "Replace HVAC Filter"
|
||||||
32
.maestro/flows/05-complete-task.yaml
Normal file
32
.maestro/flows/05-complete-task.yaml
Normal file
@@ -0,0 +1,32 @@
|
|||||||
|
# Golden path: login → open a task → Complete → fill completion fields → Submit → back on list.
|
||||||
|
appId: com.tt.honeyDue
|
||||||
|
name: Complete task
|
||||||
|
tags:
|
||||||
|
- regression
|
||||||
|
- task
|
||||||
|
---
|
||||||
|
- runFlow: 01-login.yaml
|
||||||
|
- tapOn:
|
||||||
|
id: "TabBar.Tasks"
|
||||||
|
- extendedWaitUntil:
|
||||||
|
visible:
|
||||||
|
id: "Task.List"
|
||||||
|
timeout: 10000
|
||||||
|
- tapOn:
|
||||||
|
id: "Task.Card"
|
||||||
|
- extendedWaitUntil:
|
||||||
|
visible:
|
||||||
|
id: "TaskDetail.View"
|
||||||
|
timeout: 10000
|
||||||
|
- tapOn:
|
||||||
|
id: "TaskDetail.CompleteButton"
|
||||||
|
- tapOn:
|
||||||
|
id: "TaskCompletion.NotesField"
|
||||||
|
- inputText: "Completed via Maestro golden-path test."
|
||||||
|
- hideKeyboard
|
||||||
|
- tapOn:
|
||||||
|
id: "TaskCompletion.SubmitButton"
|
||||||
|
- extendedWaitUntil:
|
||||||
|
visible:
|
||||||
|
id: "Task.List"
|
||||||
|
timeout: 15000
|
||||||
30
.maestro/flows/06-join-residence.yaml
Normal file
30
.maestro/flows/06-join-residence.yaml
Normal file
@@ -0,0 +1,30 @@
|
|||||||
|
# Golden path: login → Residences → Join → enter share code → Join.
|
||||||
|
appId: com.tt.honeyDue
|
||||||
|
name: Join residence by share code
|
||||||
|
tags:
|
||||||
|
- smoke
|
||||||
|
- residence
|
||||||
|
---
|
||||||
|
- runFlow: 01-login.yaml
|
||||||
|
- tapOn:
|
||||||
|
id: "TabBar.Residences"
|
||||||
|
- extendedWaitUntil:
|
||||||
|
visible:
|
||||||
|
id: "Residence.JoinButton"
|
||||||
|
timeout: 10000
|
||||||
|
- tapOn:
|
||||||
|
id: "Residence.JoinButton"
|
||||||
|
- extendedWaitUntil:
|
||||||
|
visible:
|
||||||
|
id: "JoinResidence.ShareCodeField"
|
||||||
|
timeout: 10000
|
||||||
|
- tapOn:
|
||||||
|
id: "JoinResidence.ShareCodeField"
|
||||||
|
- inputText: "ABC123"
|
||||||
|
- hideKeyboard
|
||||||
|
- tapOn:
|
||||||
|
id: "JoinResidence.JoinButton"
|
||||||
|
- extendedWaitUntil:
|
||||||
|
visible:
|
||||||
|
id: "Residence.List"
|
||||||
|
timeout: 15000
|
||||||
32
.maestro/flows/07-upload-document.yaml
Normal file
32
.maestro/flows/07-upload-document.yaml
Normal file
@@ -0,0 +1,32 @@
|
|||||||
|
# Golden path: login → Documents tab → Add → fill form → Save.
|
||||||
|
# File picker is exercised via FilePicker tap; OS chooser is platform-dependent
|
||||||
|
# and is skipped in CI by seeding a stub document.
|
||||||
|
appId: com.tt.honeyDue
|
||||||
|
name: Upload document
|
||||||
|
tags:
|
||||||
|
- smoke
|
||||||
|
- document
|
||||||
|
---
|
||||||
|
- runFlow: 01-login.yaml
|
||||||
|
- tapOn:
|
||||||
|
id: "TabBar.Documents"
|
||||||
|
- extendedWaitUntil:
|
||||||
|
visible:
|
||||||
|
id: "Document.AddButton"
|
||||||
|
timeout: 10000
|
||||||
|
- tapOn:
|
||||||
|
id: "Document.AddButton"
|
||||||
|
- tapOn:
|
||||||
|
id: "DocumentForm.TitleField"
|
||||||
|
- inputText: "Home Inspection Report"
|
||||||
|
- tapOn:
|
||||||
|
id: "DocumentForm.NotesField"
|
||||||
|
- inputText: "Annual inspection — Maestro smoke test."
|
||||||
|
- hideKeyboard
|
||||||
|
- tapOn:
|
||||||
|
id: "DocumentForm.SaveButton"
|
||||||
|
- extendedWaitUntil:
|
||||||
|
visible:
|
||||||
|
id: "Document.List"
|
||||||
|
timeout: 15000
|
||||||
|
- assertVisible: "Home Inspection Report"
|
||||||
24
.maestro/flows/08-theme-switch.yaml
Normal file
24
.maestro/flows/08-theme-switch.yaml
Normal file
@@ -0,0 +1,24 @@
|
|||||||
|
# Golden path: login → Profile → Settings → theme picker → select Ocean.
|
||||||
|
# Verifies persisted theme selection is applied (ThemeManager.setTheme).
|
||||||
|
appId: com.tt.honeyDue
|
||||||
|
name: Theme switch to Ocean
|
||||||
|
tags:
|
||||||
|
- regression
|
||||||
|
- profile
|
||||||
|
---
|
||||||
|
- runFlow: 01-login.yaml
|
||||||
|
- tapOn:
|
||||||
|
id: "TabBar.Profile"
|
||||||
|
- extendedWaitUntil:
|
||||||
|
visible:
|
||||||
|
id: "Profile.SettingsButton"
|
||||||
|
timeout: 10000
|
||||||
|
- tapOn:
|
||||||
|
id: "Profile.SettingsButton"
|
||||||
|
- tapOn: "Theme"
|
||||||
|
- tapOn: "Ocean"
|
||||||
|
- assertVisible: "Ocean"
|
||||||
|
- tapOn:
|
||||||
|
id: "Navigation.BackButton"
|
||||||
|
- assertVisible:
|
||||||
|
id: "TabBar.Profile"
|
||||||
20
.maestro/flows/09-notification-deeplink.yaml
Normal file
20
.maestro/flows/09-notification-deeplink.yaml
Normal file
@@ -0,0 +1,20 @@
|
|||||||
|
# Golden path: cold-launch via deeplink honeydue://task/<id> resolves to task detail.
|
||||||
|
# Requires a valid task id for the logged-in test account. CI can seed a fixture
|
||||||
|
# id via environment/script and interpolate; here we use "test-task-id" as a
|
||||||
|
# placeholder that a seed-step can replace.
|
||||||
|
appId: com.tt.honeyDue
|
||||||
|
name: Notification deeplink opens task
|
||||||
|
tags:
|
||||||
|
- regression
|
||||||
|
- deeplink
|
||||||
|
env:
|
||||||
|
TASK_ID: "test-task-id"
|
||||||
|
---
|
||||||
|
- runFlow: 01-login.yaml
|
||||||
|
- openLink: "honeydue://task/${TASK_ID}"
|
||||||
|
- extendedWaitUntil:
|
||||||
|
visible:
|
||||||
|
id: "TaskDetail.View"
|
||||||
|
timeout: 15000
|
||||||
|
- assertVisible:
|
||||||
|
id: "TaskDetail.CompleteButton"
|
||||||
29
.maestro/flows/10-widget-complete.yaml
Normal file
29
.maestro/flows/10-widget-complete.yaml
Normal file
@@ -0,0 +1,29 @@
|
|||||||
|
# Android-only: simulates a home-screen widget "complete task" tap by firing
|
||||||
|
# the widget's deeplink URI directly. Maestro does not render the Android home
|
||||||
|
# screen / App Widget host, so we exercise the underlying intent that the
|
||||||
|
# widget's PendingIntent targets (honeydue://task/<id>/complete). On iOS this
|
||||||
|
# flow is a no-op — iOS does not ship an equivalent widget surface yet.
|
||||||
|
appId: com.tt.honeyDue
|
||||||
|
name: Widget tap completes task (Android)
|
||||||
|
tags:
|
||||||
|
- android-only
|
||||||
|
- widget
|
||||||
|
env:
|
||||||
|
TASK_ID: "test-task-id"
|
||||||
|
---
|
||||||
|
- runFlow: 01-login.yaml
|
||||||
|
- openLink: "honeydue://task/${TASK_ID}/complete"
|
||||||
|
- extendedWaitUntil:
|
||||||
|
visible:
|
||||||
|
id: "TaskCompletion.SubmitButton"
|
||||||
|
timeout: 15000
|
||||||
|
- tapOn:
|
||||||
|
id: "TaskCompletion.NotesField"
|
||||||
|
- inputText: "Completed via widget simulation."
|
||||||
|
- hideKeyboard
|
||||||
|
- tapOn:
|
||||||
|
id: "TaskCompletion.SubmitButton"
|
||||||
|
- extendedWaitUntil:
|
||||||
|
visible:
|
||||||
|
id: "Task.List"
|
||||||
|
timeout: 15000
|
||||||
68
docs/maestro.md
Normal file
68
docs/maestro.md
Normal file
@@ -0,0 +1,68 @@
|
|||||||
|
# Maestro UI Flows
|
||||||
|
|
||||||
|
This directory's sibling `.maestro/` holds cross-platform UI tests driven by
|
||||||
|
[Maestro](https://maestro.mobile.dev/). The same YAML files run on both
|
||||||
|
Android and iOS because every selector uses an `id:` that resolves to an
|
||||||
|
`AccessibilityIds` test tag (Kotlin) or `AccessibilityIdentifiers` test tag
|
||||||
|
(Swift) — the two namespaces are kept in verbatim parity.
|
||||||
|
|
||||||
|
## Install
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -Ls "https://get.maestro.mobile.dev" | bash
|
||||||
|
```
|
||||||
|
|
||||||
|
Verify:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
maestro --version
|
||||||
|
```
|
||||||
|
|
||||||
|
## Run the suite
|
||||||
|
|
||||||
|
With an Android emulator running (API 34+) or an iOS simulator booted and
|
||||||
|
the HoneyDue debug build installed:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# All flows (reads .maestro/config.yaml)
|
||||||
|
maestro test .maestro/flows/
|
||||||
|
|
||||||
|
# Single flow
|
||||||
|
maestro test .maestro/flows/01-login.yaml
|
||||||
|
```
|
||||||
|
|
||||||
|
Override environment variables (see `09-notification-deeplink.yaml`,
|
||||||
|
`10-widget-complete.yaml`):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
maestro test -e TASK_ID=123e4567-e89b-12d3-a456-426614174000 \
|
||||||
|
.maestro/flows/09-notification-deeplink.yaml
|
||||||
|
```
|
||||||
|
|
||||||
|
## Available flows
|
||||||
|
|
||||||
|
| # | File | What it exercises |
|
||||||
|
|---|---|---|
|
||||||
|
| 01 | `01-login.yaml` | Email+password sign-in, land on tabs |
|
||||||
|
| 02 | `02-register.yaml` | New-user registration → verification stub |
|
||||||
|
| 03 | `03-create-residence.yaml` | Add a residence end-to-end |
|
||||||
|
| 04 | `04-create-task.yaml` | Add a task end-to-end |
|
||||||
|
| 05 | `05-complete-task.yaml` | Open task → complete → submit |
|
||||||
|
| 06 | `06-join-residence.yaml` | Join existing residence by share code |
|
||||||
|
| 07 | `07-upload-document.yaml` | Add a document |
|
||||||
|
| 08 | `08-theme-switch.yaml` | Profile → theme picker → Ocean |
|
||||||
|
| 09 | `09-notification-deeplink.yaml` | `honeydue://task/<id>` cold-launch |
|
||||||
|
| 10 | `10-widget-complete.yaml` | Android widget complete-intent (no-op on iOS) |
|
||||||
|
|
||||||
|
## Tips
|
||||||
|
|
||||||
|
- `maestro studio` opens an interactive inspector that lets you record
|
||||||
|
taps/typing and see every `testTag` the app exposes. Easiest way to
|
||||||
|
build new flows.
|
||||||
|
- `maestro test --debug-output /tmp/maestro` emits screenshots + logs for
|
||||||
|
each step — check there first when CI fails.
|
||||||
|
- Pre-seed a test user and fixture data via the API before running the
|
||||||
|
suite; the flows assume `testuser@example.com / TestPassword123!` exists.
|
||||||
|
- Keep new flows in sync with `AccessibilityIds.kt` (Kotlin) and
|
||||||
|
`AccessibilityIdentifiers.swift` (iOS) — these are the single source of
|
||||||
|
truth for every `id:` selector.
|
||||||
Reference in New Issue
Block a user