mobile-app-testing
Comprehensive mobile app testing strategies for iOS and Android. Covers unit tests, UI tests, integration tests, performance testing, and test automation with Detox, Appium, and XCTest.
Best use case
mobile-app-testing is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Comprehensive mobile app testing strategies for iOS and Android. Covers unit tests, UI tests, integration tests, performance testing, and test automation with Detox, Appium, and XCTest.
Teams using mobile-app-testing should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/mobile-app-testing/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How mobile-app-testing Compares
| Feature / Agent | mobile-app-testing | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Comprehensive mobile app testing strategies for iOS and Android. Covers unit tests, UI tests, integration tests, performance testing, and test automation with Detox, Appium, and XCTest.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Mobile App Testing
## Overview
Implement comprehensive testing strategies for mobile applications including unit tests, UI tests, integration tests, and performance testing.
## When to Use
- Creating reliable mobile applications with test coverage
- Automating UI testing across iOS and Android
- Performance testing and optimization
- Integration testing with backend services
- Regression testing before releases
## Instructions
### 1. **React Native Testing with Jest & Detox**
```javascript
// Unit test with Jest
import { calculate } from '../utils/math';
describe('Math utilities', () => {
test('should add two numbers', () => {
expect(calculate.add(2, 3)).toBe(5);
});
test('should handle negative numbers', () => {
expect(calculate.add(-2, 3)).toBe(1);
});
});
// Component unit test
import React from 'react';
import { render, screen } from '@testing-library/react-native';
import { UserProfile } from '../components/UserProfile';
describe('UserProfile Component', () => {
test('renders user name correctly', () => {
const mockUser = { id: '1', name: 'John Doe', email: 'john@example.com' };
render(<UserProfile user={mockUser} />);
expect(screen.getByText('John Doe')).toBeTruthy();
});
test('handles missing user gracefully', () => {
render(<UserProfile user={null} />);
expect(screen.getByText(/no user data/i)).toBeTruthy();
});
});
// E2E Testing with Detox
describe('Login Flow E2E Test', () => {
beforeAll(async () => {
await device.launchApp();
});
beforeEach(async () => {
await device.reloadReactNative();
});
it('should login successfully with valid credentials', async () => {
await waitFor(element(by.id('emailInput')))
.toBeVisible()
.withTimeout(5000);
await element(by.id('emailInput')).typeText('user@example.com');
await element(by.id('passwordInput')).typeText('password123');
await element(by.id('loginButton')).multiTap();
await waitFor(element(by.text('Home Feed')))
.toBeVisible()
.withTimeout(5000);
});
it('should show error with invalid credentials', async () => {
await element(by.id('emailInput')).typeText('invalid@example.com');
await element(by.id('passwordInput')).typeText('wrongpass');
await element(by.id('loginButton')).multiTap();
await waitFor(element(by.text(/invalid credentials/i)))
.toBeVisible()
.withTimeout(5000);
});
it('should navigate between tabs', async () => {
await element(by.id('profileTab')).tap();
await waitFor(element(by.text('Profile')))
.toBeVisible()
.withTimeout(2000);
await element(by.id('homeTab')).tap();
await waitFor(element(by.text('Home Feed')))
.toBeVisible()
.withTimeout(2000);
});
});
```
### 2. **iOS Testing with XCTest**
```swift
import XCTest
@testable import MyApp
class UserViewModelTests: XCTestCase {
var viewModel: UserViewModel!
var mockNetworkService: MockNetworkService!
override func setUp() {
super.setUp()
mockNetworkService = MockNetworkService()
viewModel = UserViewModel(networkService: mockNetworkService)
}
func testFetchUserSuccess() async {
let expectedUser = User(id: UUID(), name: "John", email: "john@example.com")
mockNetworkService.mockUser = expectedUser
await viewModel.fetchUser(id: expectedUser.id)
XCTAssertEqual(viewModel.user?.name, "John")
XCTAssertNil(viewModel.errorMessage)
XCTAssertFalse(viewModel.isLoading)
}
func testFetchUserFailure() async {
mockNetworkService.shouldFail = true
await viewModel.fetchUser(id: UUID())
XCTAssertNil(viewModel.user)
XCTAssertNotNil(viewModel.errorMessage)
XCTAssertFalse(viewModel.isLoading)
}
}
class MockNetworkService: NetworkService {
var mockUser: User?
var shouldFail = false
override func fetch<T: Decodable>(
_: T.Type,
from endpoint: String
) async throws -> T {
if shouldFail {
throw NetworkError.unknown
}
return mockUser as! T
}
}
// UI Test
class LoginUITests: XCTestCase {
override func setUp() {
super.setUp()
continueAfterFailure = false
XCUIApplication().launch()
}
func testLoginFlow() {
let app = XCUIApplication()
let emailTextField = app.textFields["emailInput"]
let passwordTextField = app.secureTextFields["passwordInput"]
let loginButton = app.buttons["loginButton"]
emailTextField.tap()
emailTextField.typeText("user@example.com")
passwordTextField.tap()
passwordTextField.typeText("password123")
loginButton.tap()
let homeText = app.staticTexts["Home Feed"]
XCTAssertTrue(homeText.waitForExistence(timeout: 5))
}
func testNavigationBetweenTabs() {
let app = XCUIApplication()
let profileTab = app.tabBars.buttons["Profile"]
let homeTab = app.tabBars.buttons["Home"]
profileTab.tap()
XCTAssertTrue(app.staticTexts["Profile"].exists)
homeTab.tap()
XCTAssertTrue(app.staticTexts["Home"].exists)
}
}
```
### 3. **Android Testing with Espresso**
```kotlin
@RunWith(AndroidJUnit4::class)
class UserViewModelTest {
private lateinit var viewModel: UserViewModel
private val mockApiService = mock<ApiService>()
@Before
fun setUp() {
viewModel = UserViewModel(mockApiService)
}
@Test
fun fetchUserSuccess() = runTest {
val expectedUser = User("1", "John", "john@example.com")
`when`(mockApiService.getUser("1")).thenReturn(expectedUser)
viewModel.fetchUser("1")
assertEquals(expectedUser.name, viewModel.user.value?.name)
assertEquals(null, viewModel.errorMessage.value)
}
@Test
fun fetchUserFailure() = runTest {
`when`(mockApiService.getUser("1"))
.thenThrow(IOException("Network error"))
viewModel.fetchUser("1")
assertEquals(null, viewModel.user.value)
assertNotNull(viewModel.errorMessage.value)
}
}
// UI Test with Espresso
@RunWith(AndroidJUnit4::class)
class LoginActivityTest {
@get:Rule
val activityRule = ActivityScenarioRule(LoginActivity::class.java)
@Test
fun testLoginWithValidCredentials() {
onView(withId(R.id.emailInput))
.perform(typeText("user@example.com"))
onView(withId(R.id.passwordInput))
.perform(typeText("password123"))
onView(withId(R.id.loginButton))
.perform(click())
onView(withText("Home"))
.check(matches(isDisplayed()))
}
@Test
fun testLoginWithInvalidCredentials() {
onView(withId(R.id.emailInput))
.perform(typeText("invalid@example.com"))
onView(withId(R.id.passwordInput))
.perform(typeText("wrongpassword"))
onView(withId(R.id.loginButton))
.perform(click())
onView(withText(containsString("Invalid credentials")))
.check(matches(isDisplayed()))
}
@Test
fun testNavigationBetweenTabs() {
onView(withId(R.id.profileTab)).perform(click())
onView(withText("Profile")).check(matches(isDisplayed()))
onView(withId(R.id.homeTab)).perform(click())
onView(withText("Home")).check(matches(isDisplayed()))
}
}
```
### 4. **Performance Testing**
```swift
import XCTest
class PerformanceTests: XCTestCase {
func testListRenderingPerformance() {
let viewModel = ItemsViewModel()
viewModel.items = (0..<1000).map { i in
Item(id: UUID(), title: "Item \(i)", price: Double(i))
}
measure {
_ = viewModel.items.filter { $0.price > 50 }
}
}
func testNetworkResponseTime() {
let networkService = NetworkService()
measure {
let expectation = XCTestExpectation(description: "Fetch user")
Task {
do {
_ = try await networkService.fetch(User.self, from: "/users/test")
expectation.fulfill()
} catch {
XCTFail("Network request failed")
}
}
wait(for: [expectation], timeout: 10)
}
}
}
```
## Best Practices
### ✅ DO
- Write tests for business logic first
- Use dependency injection for testability
- Mock external API calls
- Test both success and failure paths
- Automate UI testing for critical flows
- Run tests on real devices
- Measure performance on target devices
- Keep tests isolated and independent
- Use meaningful test names
- Maintain >80% code coverage
### ❌ DON'T
- Skip testing UI-critical flows
- Use hardcoded test data
- Ignore performance regressions
- Test implementation details
- Make tests flaky or unreliable
- Skip testing on actual devices
- Ignore accessibility testing
- Create interdependent tests
- Test without mocking APIs
- Deploy untested codeRelated Skills
mobile_react_native
React Native best practices, hooks, navigation ve performance optimization.
mobile-ui-development-rule
General rules pertaining to Mobile UI development. Covers UI/UX best practices, state management, and navigation patterns.
mobile-security-expert
移动安全漏洞挖掘知识库,基于HackerOne公开报告提供Android和iOS应用的漏洞挖掘手法、技术细节和代码模式分析;用于安全研究人员和漏洞挖掘者学习参考、代码审计和漏洞检测指导。
mobile-security-coder
Expert in secure mobile coding practices specializing in input validation, WebView security, and mobile-specific security patterns.
mobile-offline-support
Implement offline-first mobile apps with local storage, sync strategies, and conflict resolution. Covers AsyncStorage, Realm, SQLite, and background sync patterns.
mobile-guide
Comprehensive mobile development guide for iOS, Android, React Native, and Flutter. Includes Swift, Kotlin, and cross-platform frameworks. Use when building mobile applications, iOS, Android, or cross-platform apps.
mobile-games
Mobile game development principles. Touch input, battery, performance, app stores.
mobile-frontend
React Native patterns, NativeWind styling, React Native Reusables components, mobile-specific patterns
mobile-first-design-rules
Focuses on rules and best practices for mobile-first design and responsive typography using tailwind.
mobile-development
Cross-platform and native mobile development. Frameworks: React Native, Flutter, Swift/SwiftUI, Kotlin/Jetpack Compose. Capabilities: mobile UI, offline-first architecture, push notifications, deep linking, biometrics, app store deployment. Actions: build, create, implement, optimize, test, deploy mobile apps. Keywords: iOS, Android, React Native, Flutter, Swift, Kotlin, mobile app, offline sync, push notification, deep link, biometric auth, App Store, Play Store, iOS HIG, Material Design, battery optimization, memory management, mobile performance. Use when: building mobile apps, implementing mobile-first UX, choosing native vs cross-platform, optimizing battery/memory/network, deploying to app stores, handling mobile-specific features.
mobile-developer
Develop React Native, Flutter, or native mobile apps with modern architecture patterns. Masters cross-platform development, native integrations, offline sync, and app store optimization. Use PROACTIVELY for mobile features, cross-platform code, or app optimization.
mobile-design
Mobile-first design and engineering doctrine for iOS and Android apps. Covers touch interaction, performance, platform conventions, offline behavior, and mobile-specific decision-making. Teaches pr...