// Build the project, run tests, lint, format, spell check, generate mocks, or verify the build passes for Bitwarden iOS. Use when asked to "build", "run tests", "lint", "format", "verify build", "check if it compiles", "run swiftlint", "run swiftformat", "generate mocks", or to execute any part of the build/test/verify pipeline.
Convert an XCTest file to Swift Testing framework. Use when asked to "convert to Swift Testing", "migrate XCTest", "convert test file", "xctest to swift testing", "migrate tests to Swift Testing", or when explicitly asked to convert existing XCTest-based tests.
Convert a hand-written bespoke mock to a Sourcery AutoMockable-generated mock. Use this skill whenever the user says "convert this mock", "migrate mock to AutoMockable", "replace bespoke mock", "use Sourcery for this mock", or mentions wanting to convert a Mock*.swift file to use `// sourcery: AutoMockable`. Also use this skill proactively when you notice a new protocol being created without the annotation, or when an existing bespoke mock is being modified and AutoMockable would be sufficient.
Write tests, add test coverage, unit test, or add missing tests for Bitwarden iOS. Use when asked to "write tests", "add test coverage", "test this", "unit test", "add tests for", "missing tests", or when creating test files for new implementations.
Implement, write code, add a new screen, create a feature, new view, new processor, or wire up a new service in Bitwarden iOS. Use when asked to "implement", "write code", "add screen", "create feature", "new view", "new processor", "add service", or when translating a design doc into actual Swift code.
Plan implementation, design an approach, or create an architecture plan for a Bitwarden iOS feature. Use when asked to "plan implementation", "design approach", "architecture plan", "how should I implement", "what files do I need", or to create a design doc before writing code.
Refine requirements, analyze a ticket, perform gap analysis, or clarify what a Jira/Confluence ticket is asking before coding in Bitwarden iOS. Use when asked to "refine requirements", "analyze ticket", "gap analysis", "clarify ticket", "what does this ticket mean", or to understand scope before implementation begins.
| name | build-test-verify |
| description | Build the project, run tests, lint, format, spell check, generate mocks, or verify the build passes for Bitwarden iOS. Use when asked to "build", "run tests", "lint", "format", "verify build", "check if it compiles", "run swiftlint", "run swiftformat", "generate mocks", or to execute any part of the build/test/verify pipeline. |
brew bundle # Install Homebrew dependencies
./Scripts/bootstrap.sh # Generate Xcode projects, install Mint packages, set up git hooks
Git hooks set up by bootstrap.sh:
post-checkout / post-merge — automatically re-run bootstrap.sh.xcodeproj files are gitignored and must be generated before building:
mint run xcodegen --spec project-pm.yml # Password Manager
mint run xcodegen --spec project-bwa.yml # Authenticator
mint run xcodegen --spec project-bwk.yml # BitwardenKit
mint run xcodegen --spec project-bwth.yml # Test Harness
Or run all at once via ./Scripts/bootstrap.sh.
./Scripts/build.sh project-pm.yml Bitwarden Simulator # PM for simulator
./Scripts/build.sh project-bwa.yml Authenticator Simulator # Authenticator for simulator
./Scripts/build.sh project-bwth.yml TestHarness Simulator # Test Harness for simulator
./Scripts/build.sh project-pm.yml Bitwarden Device # PM for device
Always read the simulator config files before running tests:
DEVICE=$(tr -d '\n' < .test-simulator-device-name)
OS=$(tr -d '\n' < .test-simulator-ios-version)
Then run tests with:
xcodebuild test \
-workspace Bitwarden.xcworkspace \
-scheme Bitwarden \
-testPlan Bitwarden-Default \
-destination "platform=iOS Simulator,name=$DEVICE,OS=$OS"
Current values (as of last update): device iPhone 17 Pro, OS 26.2. Do not hardcode these — always read from .test-simulator-device-name and .test-simulator-ios-version at runtime, as they change when the project upgrades its simulator target.
CI runs all -Default test plans on PRs to main, commits to main, and release branches. Test execution order is randomized (randomExecutionOrder: true).
Snapshot tests are currently disabled. Do not run or re-record them. If you encounter a snapshot test, prefix the function name with disable (e.g., disabletest_snapshot_defaultState).
mint run swiftlint # Lint (custom rules: todo_without_jira, weak_navigator, style_guide_font)
mint run swiftformat . # Auto-fix formatting (4-space indent, Swift 6.2)
mint run swiftformat --lint --lenient . # Check formatting without fixing
typos # Spell check
SwiftLint and SwiftFormat run automatically as post-compile scripts (configured in project-pm.yml).
Run automatically in pre-build phases; trigger manually when needed:
# Mock generation — run from an Xcode build phase (BUILD_DIR is set automatically by Xcode)
# To run standalone, supply BUILD_DIR manually — see the script header for the one-liner
./Scripts/generate-mocks.sh BitwardenShared # default if argument omitted
./Scripts/generate-mocks.sh AuthenticatorShared
./Scripts/generate-mocks.sh BitwardenKit
# Asset/localization code generation
mint run swiftgen config run --config swiftgen-bwr.yml # BitwardenResources (most common)
mint run swiftgen config run --config swiftgen-pm.yml # Password Manager
mint run swiftgen config run --config swiftgen-bwa.yml # Authenticator
mint run swiftgen config run --config swiftgen-bwth.yml # Test Harness
| Tool | Config | Purpose |
|---|---|---|
| XcodeGen | project-*.yml | Generates .xcodeproj from YAML specs |
| Mint | Mintfile | Swift tool package manager |
| SwiftLint | .swiftlint.yml | Linting with custom rules |
| SwiftFormat | .swiftformat | Code formatting |
| Sourcery | */Sourcery/sourcery.yml | Mock generation (AutoMockable) |
| SwiftGen | swiftgen-*.yml | Asset/localization code generation |
| typos | project config | Spell checking |
| Fastlane | fastlane/Fastfile | CI/CD automation |
| Problem | Cause | Fix |
|---|---|---|
.xcodeproj not found | Files are gitignored | Run ./Scripts/bootstrap.sh |
MockXxx not found | Sourcery not run | Add // sourcery: AutoMockable, run Sourcery or build |
| Snapshot test runs | Snapshots are currently disabled | Prefix function name with disable (e.g., disabletest_snapshot_defaultState) |
| Extension crash on unlock | Argon2id KDF > 64 MB | Check maxArgon2IdMemoryBeforeExtensionCrashing in Constants.swift |
| SwiftLint TODO warning | Missing JIRA ticket | // TODO: PM-12345 - description |
ErrorReporter protocol + OSLogErrorReporter for developmentBitwardenSdkAPIService implementations in Networking/print(subject.state) in processor tests to inspect state changes