Skip to content

docs(testing): document local Appium smoke runs in e2e-testing skill#54

Open
racitores wants to merge 1 commit into
mainfrom
docs/e2e-testing-local-appium-runs
Open

docs(testing): document local Appium smoke runs in e2e-testing skill#54
racitores wants to merge 1 commit into
mainfrom
docs/e2e-testing-local-appium-runs

Conversation

@racitores

Copy link
Copy Markdown

Summary

  • Adds domains/testing/skills/e2e-testing/references/running-tests-locally.md with step-by-step guidance for running MetaMask Mobile Appium smoke tests locally.
  • Documents the main-e2e release build workflow agents should use (CI artifact main-e2e-MetaMask.app on iOS — same build validated in recent mobile Appium smoke runs).
  • Updates the metamask-mobile overlay with an Agent execution standard section that points agents to the reference first, including build selection, env overrides, simulator prep, and Android ABI caveats.
  • Expands e2e-testing skill description to mention Appium local runs vs Detox (e2e-test skill).

Key agent rules captured

  1. Use main-e2e release builds for Appium smoke — not Detox debug / Expo dev-launcher APKs.
  2. Download CI artifacts via gh run download (main-e2e-MetaMask.app, main-e2e-release.apk).
  3. Always set IOS_APP_PATH so .e2e.env PREBUILT_* debug paths do not override.
  4. Boot simulator → prepare-ios-appium-runner.mjs → run yarn appium-smoke:ios with IOS_SIMULATOR_UDID.
  5. Prefer iOS on Mac for local Appium validation (CI Android APK is x86_64-only).

Test plan

  • Skill markdown renders valid frontmatter
  • Reference links resolve from repos/metamask-mobile.md
  • Reviewer: confirm artifact names match current build / Appium CI workflows in metamask-mobile

Made with Cursor

Document how agents and engineers run metamask-mobile Appium smoke tests
locally using main-e2e CI release builds (main-e2e-MetaMask.app on iOS),
including artifact download, simulator prep, env overrides, and Android ABI caveats.

Co-authored-by: Cursor <cursoragent@cursor.com>
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