Run any Skill in Manus with one click

$pwd:

build-test-verify

Name: Build Test Verify
Author: bitwarden

// 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.

Run Skill in Manus

$ git log --oneline --stat

stars:598

forks:123

updated:April 30, 2026 at 15:20

SKILL.md

readonly

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.

Build, Test, and Verify — Bitwarden iOS

Initial Setup

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

Project Generation

.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.

Building

./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

Running Tests

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).

Lint, Format, Spell Check

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).

Code Generation

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

Tooling Reference

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

Common Failures

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`

Debug Tips

Error reporting: ErrorReporter protocol + OSLogErrorReporter for development
Flight recorder: In-app logging for debugging production issues
SDK diagnostics: Xcode console errors prefixed BitwardenSdk
Network debugging: Set breakpoints in APIService implementations in Networking/
State debugging: print(subject.state) in processor tests to inspect state changes

related-skills.json

same repository

converting-xctest-to-swift-testing.md

from "bitwarden/ios"

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.

2026-05-12598

converting-mocks-to-automockable.md

from "bitwarden/ios"

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.

2026-05-04598

testing-ios-code.md

from "bitwarden/ios"

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.

2026-04-30598

implementing-ios-code.md

from "bitwarden/ios"

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.

2026-04-08598

planning-ios-implementation.md

from "bitwarden/ios"

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.

2026-04-08598

refining-ios-requirements.md

from "bitwarden/ios"

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.

2026-04-08598

package.json

"author": "bitwarden"

"repository": "bitwarden/ios"

View GitHub Repository View Creator Repositories

$ install --global

$ download --local

Run Skill in Manus

$ useful --forSOC

Software Quality Assurance Analysts and TestersComputer and Mathematical Occupations15-1253L4

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.

Build, Test, and Verify — Bitwarden iOS

Initial Setup

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

Project Generation

.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.

Building

./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

Running Tests

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"

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).

Lint, Format, Spell Check

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).

Code Generation

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

Tooling Reference

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

Common Failures

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`

Debug Tips

Error reporting: ErrorReporter protocol + OSLogErrorReporter for development
Flight recorder: In-app logging for debugging production issues
SDK diagnostics: Xcode console errors prefixed BitwardenSdk
Network debugging: Set breakpoints in APIService implementations in Networking/
State debugging: print(subject.state) in processor tests to inspect state changes

build-test-verify

Build, Test, and Verify — Bitwarden iOS

Initial Setup

Project Generation

Building

Running Tests

Lint, Format, Spell Check

Code Generation

Tooling Reference

Common Failures

Debug Tips

More from this repository

More from this repository

Build, Test, and Verify — Bitwarden iOS

Initial Setup

Project Generation

Building

Running Tests

Lint, Format, Spell Check

Code Generation

Tooling Reference

Common Failures

Debug Tips