| .. | ||
| .env.example | ||
| admin-const-edit-delivery-charge.yaml | ||
| admin-product-search.yaml | ||
| config.yaml | ||
| README.md | ||
| run.sh | ||
| user-cart-add-item.yaml | ||
| user-cart-select-address.yaml | ||
| user-login-password.yaml | ||
| user-region-confirm-switch.yaml | ||
| user-region-gate-manual-pick.yaml | ||
Region E2E tests (Maestro)
Region/location flows for the user-ui app (com.freshyotrial.app) and the
admin-ui app (in.freshyo.adminui) on an iOS simulator. Kept in this
subdirectory (with its own config.yaml) so the parent tests/e2e suite glob
does not pick them up — they need seeded multi-region data (see below).
Layout
tests/e2e/regions/
config.yaml # workspace config for this suite only
run.sh # loads .env and runs `maestro test`
.env.example # copy to .env and fill in
user-region-gate-manual-pick.yaml # test 13: gate picker -> home
user-login-password.yaml # reusable password login (OTP-free)
user-cart-add-item.yaml # add first product + first slot -> cart
user-cart-select-address.yaml # test 18: cross-region address preview
user-region-confirm-switch.yaml # tests 16/17: confirm + results dialog
admin-product-search.yaml # tests 5/6: product visible/absent
admin-const-edit-delivery-charge.yaml# test 4.1: edit own-region charge
The admin login step reuses ../subflows/login.yaml (STAFF_NAME/STAFF_PASSWORD).
Prerequisites
- Maestro CLI + a booted iOS simulator with both apps installed.
- Backend reachable from the simulator (
BASE_API_URLinpackages/shared). - Multi-region seed data: at least 2 regions, a user account with addresses in
both regions and a non-empty scheduled cart for the address flows. The flows
were validated against regions
Mahabubnagar(1) andT-Hyd(2); adjust.env(GATE_REGION_NAME,ADDRESS_LABEL,PRODUCT_NAME) for your data. - Known limits (verified Oct 2026): the user app reads products/slots/offers
from uploaded cache files — regions without uploaded cache sets render the
Oops! Failed to load …states instead of product lists.
Setup / run
cp tests/e2e/regions/.env.example tests/e2e/regions/.env
# edit tests/e2e/regions/.env
bash tests/e2e/regions/run.sh # whole suite in config order
bash tests/e2e/regions/run.sh user-cart-add-item.yaml # single flow
Test-case mapping
multi-region-tests.txt: 5, 6 (admin search), 13 (gate pick), 16, 17, 18 (select address, confirm, results), 4.1-analogue (const edit).docs/region-test-cases.txt: §12.10 (address watcher), §12.4 (switch + reconcile), §13.4 (manual pick), §13.10 (bars — asserted via testIDs on the landing screens), §19.5 (cart selector, checkout card — same screens).