Add Appium mobile test automation rule

[tugkanboz]

Adds an Appium mobile test automation rule to the Testing section.

The Testing list currently covers web and API testing (Cypress, Playwright, Jest, Vitest) but has no mobile testing entry. This adds cross-platform mobile coverage for Android and iOS.

The rule follows the same structure as the existing testing rules: frontmatter, an expert persona, language and platform auto-detection, and focused sections for the Page Object Model, locator and context strategy, waits and app state, capabilities and devices, reliability with retries, and CI/CD reporting.

Adapted from an Appium framework setup I maintain here: https://github.com/tugkanboz/awesome-cursorrules

Summary by CodeRabbit

• Documentation
  • Added comprehensive guidance for mobile UI test automation across Android and iOS platforms, including test structure, locator strategies, device configuration, and reliability best practices.

[coderabbitai]

📝 Walkthrough

Walkthrough

This PR adds a new Cursor rule set for Appium mobile testing. A new .mdc file provides comprehensive guidance for writing cross-platform Android and iOS UI tests, and the README Testing section is updated with a link to the new rule.

Appium Mobile Testing Rule

Layer / File(s)

Summary

Appium Mobile Testing Rules and Registration rules/appium-mobile-testing-cursorrules-prompt-file.mdc, README.md

New Cursor rule file provides comprehensive guidance for Appium test automation: detecting project language/platform, structuring tests with shared interfaces and Page Object Model, selecting robust locators and managing context switching, using explicit waits and handling app lifecycle/permissions, configuring devices and setup/teardown, organizing tests by feature/screen with platform-specific tags, and implementing retry/recovery and failure reporting. README Testing section is updated to index the new rule.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Suggested reviewers

• PatrickJS

Poem

🐰 A new rule hops into the Testing pen,
Appium guidance for Android, iOS again,
Mobile tests now have a structured way,
With Page Objects and waits that play—
Cross-platform testing, hooray! 📱

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and concisely summarizes the main change: adding a new Appium mobile test automation rule.
Description check	✅ Passed	The description is largely complete with summary, context, and file changes, but the Quality Checklist section from the template is not filled out.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

🧹 Nitpick comments (1)

rules/appium-mobile-testing-cursorrules-prompt-file.mdc (1)

3-4: ⚡ Quick win

Narrow the rule scope for better auto-attach precision.

Line 3 uses globs: **/* with alwaysApply: false, which effectively targets the whole repo and can cause this Appium-specific rule to attach in unrelated contexts. Consider narrowing to likely mobile test/config files (for example, Java/Kotlin/Python test paths and Appium config files).

Suggested frontmatter adjustment

-description: "Cursor rules for Appium development with mobile (Android and iOS) test automation."
-globs: **/*
+description: "Cursor rules for Appium development with mobile (Android and iOS) test automation."
+globs: **/*test*.py, **/*test*.java, **/*test*.kt, **/appium*.{js,ts,json,yml,yaml}, **/*capabilities*.{json,yml,yaml}
 alwaysApply: false

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@rules/appium-mobile-testing-cursorrules-prompt-file.mdc` around lines 3 - 4,
The rule's frontmatter currently uses a broad glob pattern ("globs: **/*")
causing it to match the entire repo; narrow the scope by replacing that pattern
with targeted globs that match likely mobile test and Appium config files (for
example test/source folders and filetypes) such as Java/Kotlin/Python test
directories and Appium config filenames so the rule only auto-attaches for
mobile-test contexts; update the frontmatter entries that reference "globs" and
"alwaysApply" (the current symbols to change) to include specific patterns for
test paths and Appium config files instead of a repository-wide "**/*".

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In `@rules/appium-mobile-testing-cursorrules-prompt-file.mdc`:
- Around line 3-4: The rule's frontmatter currently uses a broad glob pattern
("globs: **/*") causing it to match the entire repo; narrow the scope by
replacing that pattern with targeted globs that match likely mobile test and
Appium config files (for example test/source folders and filetypes) such as
Java/Kotlin/Python test directories and Appium config filenames so the rule only
auto-attaches for mobile-test contexts; update the frontmatter entries that
reference "globs" and "alwaysApply" (the current symbols to change) to include
specific patterns for test paths and Appium config files instead of a
repository-wide "**/*".

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 95d6d911-4b3a-4bad-bea8-8074ead6c937

📥 Commits

Reviewing files that changed from the base of the PR and between b044f95 and 8eddc57.

📒 Files selected for processing (2)

• README.md
• rules/appium-mobile-testing-cursorrules-prompt-file.mdc