ios-testing
/ios-testing
Testing practices for iOS 26 / Swift 6.2 clinic modular MVVM-C applications. Covers unit/UI/snapshot testing, protocol-based mocks, async actor isolation, and dependency-injected test architecture aligned with Domain protocols, App-target composition, and Data-owned I/O boundaries. Use when writing, reviewing, or refactoring tests for ios-* and swift-* clinic modules.
- Author
- pproenca ↗
- Repository
- dot-skills ↗
- Licence
- MIT
- Last repository change
- 15.08.2026
Assessment and security
- Files in this package
- 48
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 15.08.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Testing practices for iOS 26 / Swift 6.2 clinic modular MVVM-C applications. Covers unit/UI/snapshot testing, protocol-based mocks, async actor isolation, and dependency-injected test architecture aligned with Domain protocols, App-target composition, and Data-owned I/O boundaries. Use when writing, reviewing, or refactoring tests for ios-* and swift-* clinic modules.
Original author description
Testing practices for iOS 26 / Swift 6.2 clinic modular MVVM-C applications. Covers unit/UI/snapshot testing, protocol-based mocks, async actor isolation, and dependency-injected test architecture aligned with Domain protocols, App-target composition, and Data-owned I/O boundaries. Use when writing, reviewing, or refactoring tests for ios-* and swift-* clinic modules.
How it works
- Clinic Architecture Contract (iOS 26 / Swift 6.2)
- When to Apply
- Rule Categories by Priority
- Quick Reference
- How to Use
- Reference Files
SKILL.md preview
--- name: ios-testing description: Testing practices for iOS 26 / Swift 6.2 clinic modular MVVM-C applications. Covers unit/UI/snapshot testing, protocol-based mocks, async actor isolation, and dependency-injected test architecture aligned with Domain protocols, App-target composition, and Data-owned I/O boundaries. Use when writing, reviewing, or refactoring tests for ios-* and swift-* clinic modules. --- # iOS Testing Best Practices Comprehensive testing guide for iOS and Swift applications, written at principal engineer level. Contains 44 rules across 8 categories, prioritized by impact to guide test architecture decisions, test authoring patterns, and CI infrastructure. ## Clinic Architecture Contract (iOS 26 / Swift 6.2) All guidance in this skill assumes the clinic modular MVVM-C architecture: - Feature modules import `Domain` + `DesignSystem` only (never `Data`, never sibling features) - App target is the convergence point and owns `DependencyContainer`, concrete coordinators, and Route Shell wiring - `Domain` stays pure Swift and defines models plus repository, `*Coordinating`, `ErrorRouting`, and `AppError` contracts - `Data` owns SwiftData/network/sync/retry/background I/O and implements Domain protocols - Read/write flow defaults to stale-while-revalidate reads and optimistic queued writes - ViewModels call repository protocols directly (no default use-case/interactor layer) ## When to Apply Reference these guidelines when: - Writing new unit tests or UI tests for iOS apps - Designing testable architecture with dependency injection - Testing async/await, actors, and Combine publishers - Setting up snapshot testing or visual regression suites - Configuring CI pipelines, test plans, and parallel execution ## Rule Categories by Priority | Priority | Category | Impact | Prefix | |----------|----------|--------|--------| | 1 | Test Architecture & Testability | CRITICAL | `arch-` | | 2 | Unit Testing Fundamentals | CRITICAL | `unit-` | | 3 | Test Doubles & Isolation | HIGH | `mock-` | | 4 | Async & Concurrency Testing | HIGH | `async-` | | 5 | SwiftUI Testing | MEDIUM-HIGH | `swiftui-` | | 6 | UI & Acceptance Testing | MEDIUM | `ui-` | | 7 | Snapshot & Visual Testing | MEDIUM | `snap-` | | 8 | Test Reliability & CI | LOW-MEDIUM | `ci-` | ## Quick Reference ### 1. Test Architecture & Testability (CRITICAL) - [`arch-protocol-dependencies`](references/arch-protocol-dependencies.md) - Depend on protocols, not concrete types - [`arch-constructor-injection`](references/arch-constructor-injection.md) - Use constructor injection over service locators - [`arch-test-target-separation`](references/arch-test-target-separation.md) - Separate unit and UI test targets - [`arch-testable-import`](references/arch-testable-import.md) - Use @testable import sparingly - [`arch-single-responsibility-tests`](references/arch-single-responsibility-tests.md) - One assertion concept per test - [`arch-arrange-act-assert`](references/arch-arrange-act-assert.md) - Structure tests as Arrange-Act-Assert ### 2. Unit Testing Fundamentals (CRITICAL) - [`unit-swift-testing-framework`](references/unit-swift-testing-framework.md) - Use Swift Testing over XCTest for new tests - [`unit-parameterized-tests`](references/unit-parameterized-tests.md) - Use parameterized tests for input variations - [`unit-descriptive-test-names`](references/unit-descriptive-test-names.md) - Name tests after the behavior they verify - [`unit-expect-over-assert`](references/unit-expect-over-assert.md) - Use #expect and #require over XCTAssert - [`unit-require-preconditions`](references/unit-require-preconditions.md) - Use #require for test preconditions - [`unit-test-suites`](references/unit-test-suites.md) - Organize related tests into suites - [`unit-test-tags`](references/unit-test-tags.md) - Use tags to categorize cross-cutting tests ### 3. Test Doubles & Isolation (HIGH) - [`mock-protocol-based-mocks`](references/mock-protocol-based-mocks.md) - Create mocks from protocols, not subclasses - [`mock-spy-for-verification`](references/mock-spy-for-verification.md) - Use spies to verify interactions - [`mock-stub-return-values`](references/mock-stub-return-values.md) - Use stubs for deterministic return values - [`mock-avoid-over-mocking`](references/mock-avoid-over-mocking.md) - Avoid mocking value types and simple logic - [`mock-fake-for-integration`](references/mock-fake-for-integration.md) - Use in-memory fakes for integration tests - [`mock-dependency-container`](references/mock-dependency-container.md) - Use a dependency container for test configuration ### 4. Async & Concurrency Testing (HIGH) - [`async-await-directly`](references/async-await-directly.md) - Await async functions directly in tests - [`async-confirmation`](references/async-confirmation.md) - Use confirmation() for callback-based APIs - [`async-mainactor-isolation`](references/async-mainactor-isolation.md) - Test MainActor-isolated code on MainActor - [`async-actor-testing`](references/async-actor-testing.md) - Test actor state through async interface - [`async-task-cancellation`](references/async-task-cancellation.md) - Test task cancellation paths explicitly ### 5. SwiftUI Testing (MEDIUM-HIGH) - [`swiftui-test-observable-models`](references/swiftui-test-observable-models.md) - Test @Observable models as plain objects - [`swiftui-environment-injection`](references/swiftui-environment-injection.md) - Inject environment dependencies for tests - [`swiftui-preview-as-test`](references/swiftui-preview-as-test.md) - Use previews as visual smoke tests - [`swiftui-view-model-extraction`](references/swiftui-view-model-extraction.md) - Extract logic from views into testable models - [`swiftui-binding-testing`](references/swiftui-binding-testing.md) - Test binding behavior with @Bindable ### 6. UI & Acceptance Testing (MEDIUM) - [`ui-accessibility-identifiers`](references/ui-accessibility-identifiers.md) - Use accessibility identifiers for element queries - [`ui-page-object-pattern`](references/ui-page-object-pattern.md) - Encapsulate screens in page objects - [`ui-launch-arguments`](references/ui-launch-arguments.md) - Configure test state via launch arguments - [`ui-wait-for-elements`](references/ui-wait-for-elements.md) - Wait for elements instead of using sleep() - [`ui-test-user-journeys`](references/ui-test-user-journeys.md) - Test complete user journeys, not individual screens - [`ui-reset-state-between-tests`](references/ui-reset-state-between-tests.md) - Reset app state between UI tests ### 7. Snapshot & Visual Testing (MEDIUM) - [`snap-swift-snapshot-testing`](references/snap-swift-snapshot-testing.md) - Use swift-snapshot-testing for visual regression - [`snap-device-matrix`](references/snap-device-matrix.md) - Snapshot across device sizes and traits - [`snap-named-references`](references/snap-named-references.md) - Use named snapshot references for clarity - [`snap-inline-snapshots`](references/snap-inline-snapshots.md) - Use inline snapshots for non-image assertions ### 8. Test Reliability & CI (LOW-MEDIUM) - [`ci-test-plans`](references/ci-test-plans.md) - Use Xcode Test Plans for environment configurations - [`ci-parallel-execution`](references/ci-parallel-execution.md) - Enable parallel test execution - [`ci-flaky-test-quarantine`](references/ci-flaky-test-quarantine.md) - Quarantine flaky tests instead of disabling them - [`ci-deterministic-test-data`](references/ci-deterministic-test-data.md) - Use deterministic test data over random generation - [`ci-coverage-thresholds`](references/ci-coverage-thresholds.md) - Set coverage thresholds for critical paths ## How to Use Read individual reference files for detailed explanations and code examples: - [Section definitions](references/_sections.md) - Category structure and impact levels - [Rule template](assets/templates/_template.md) - Template for adding new rules ## Reference Files | File | Description | |------|-------------| | [references/_sections.md](references/_sections.md) | Category definitions and ordering | | [assets/templates/_template.md](assets/templates/_template.md) | Template for new rules | | [metadata.json](metadata.json) | Version and reference information |
Files in this package (48)
- SKILL.md 8 KB
- metadata.json 1 KB
- assets/templates/_template.md 1 KB
- references/_sections.md 2 KB
- references/arch-arrange-act-assert.md 2 KB
- references/arch-constructor-injection.md 2 KB
- references/arch-protocol-dependencies.md 2 KB
- references/arch-single-responsibility-tests.md 2 KB
- references/arch-test-target-separation.md 2 KB
- references/arch-testable-import.md 2 KB
- references/async-actor-testing.md 2 KB
- references/async-await-directly.md 1 KB
- references/async-confirmation.md 2 KB
- references/async-mainactor-isolation.md 2 KB
- references/async-task-cancellation.md 2 KB
- references/ci-coverage-thresholds.md 3 KB
- references/ci-deterministic-test-data.md 3 KB
- references/ci-flaky-test-quarantine.md 2 KB
- references/ci-parallel-execution.md 4 KB
- references/ci-test-plans.md 3 KB
- references/mock-avoid-over-mocking.md 2 KB
- references/mock-dependency-container.md 2 KB
- references/mock-fake-for-integration.md 2 KB
- references/mock-protocol-based-mocks.md 2 KB
- references/mock-spy-for-verification.md 2 KB
- references/mock-stub-return-values.md 2 KB
- references/snap-device-matrix.md 2 KB
- references/snap-inline-snapshots.md 2 KB
- references/snap-named-references.md 2 KB
- references/snap-swift-snapshot-testing.md 2 KB
- references/swiftui-binding-testing.md 2 KB
- references/swiftui-environment-injection.md 2 KB
- references/swiftui-preview-as-test.md 1 KB
- references/swiftui-test-observable-models.md 2 KB
- references/swiftui-view-model-extraction.md 2 KB
- references/ui-accessibility-identifiers.md 1 KB
- references/ui-launch-arguments.md 2 KB
- references/ui-page-object-pattern.md 3 KB
- references/ui-reset-state-between-tests.md 2 KB
- references/ui-test-user-journeys.md 2 KB
- references/ui-wait-for-elements.md 1 KB
- references/unit-descriptive-test-names.md 2 KB
- references/unit-expect-over-assert.md 2 KB
- references/unit-parameterized-tests.md 2 KB
- references/unit-require-preconditions.md 2 KB
- references/unit-swift-testing-framework.md 2 KB
- references/unit-test-suites.md 2 KB
- references/unit-test-tags.md 2 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · pproenca/dot-skills | 100 | MIT |
| ioloro/ios-testing | 100 | MIT |
Database snapshot: 13.11.2026 · package version f385f62922c1 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100ios-design
SwiftUI interface implementation patterns aligned with the iOS 26 / Swift 6.2 clinic modular MVVM-C architecture, grounded in Creative Selection and Design Like Apple principles. Use when building new SwiftUI views/screens while respecting Domain/Data boundaries, App-target… - 100swift-optimise
Swift 6.2 and SwiftUI performance optimization for iOS 26 clinic architecture codebases. Covers async/await concurrency patterns, Sendable/actor isolation, view/render performance, and animation performance while preserving modular MVVM-C boundaries across App, Feature, Domain,… - 95ios
Use this skill when the user asks about iOS development, Swift, SwiftUI, UIKit, iOS architecture, MVVM, Coordinator, Core Data, SwiftData, or iOS testing. - 100mobiai-ios-testing
Use when writing or running tests in an iOS project — unit tests, UI tests, snapshot tests, choosing the right framework. - 100swift-expert
Use this agent when building native iOS, macOS, or server-side Swift applications requiring advanced concurrency patterns, protocol-oriented architecture, and Swift-specific optimizations. Invoke for SwiftUI modernization, async/await implementation, actor-based state… - 100swift-architecture-pro
Use when structuring an iOS app — feature modularization, MVVM with @Observable, dependency injection, navigation routing, and layering for testability.