Skip to content

[PM-44082] docs: additional refinements to iOS getting-started #878

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
tomhartnett-bw merged 3 commits into from
Oct 7, 2026
Merged

[PM-44082] docs: additional refinements to iOS getting-started #878

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
f51c65d
[PM-44082] docs: additional refinements to iOS getting-started
tomhartnett-bw Oct 1, 2026
32c3c56
More refinements
tomhartnett-bw Oct 1, 2026
c42c505
Be consistent with references to repo root
tomhartnett-bw Oct 1, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 6 additions & 16 deletions docs/getting-started/mobile/ios/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,11 +22,9 @@ sidebar_position: 1
$ git clone https://github.com/bitwarden/ios
```

2. Install [Homebrew](https://brew.sh/) dependencies (including
[Mint](https://github.com/yonaskolb/mint)) from the repository root:
2. Install [Homebrew](https://brew.sh/) dependencies from the repository root:
Comment thread
tomhartnett-bw marked this conversation as resolved.

```sh
$ cd ios
$ brew bundle
```

Expand All @@ -35,15 +33,6 @@ sidebar_position: 1
> checks that they are installed, so re-run `brew bundle` if bootstrapping reports missing
> dependencies.

Alternatively, if you prefer to install Mint without `brew`, clone the Mint repo into a temporary
directory and run `make`.

```sh
$ git clone https://github.com/yonaskolb/Mint.git
$ cd Mint
$ make
```

3. Bootstrap the project:

```sh
Expand Down Expand Up @@ -77,7 +66,8 @@ sidebar_position: 1
Current version: 16.4
```

4. Install [fastlane](https://docs.fastlane.tools/) for automated package deployments:
4. (Optional) Install [fastlane](https://docs.fastlane.tools/) if you're developing or testing CI
and automation workflows locally:

> **Note** We manage non-system Ruby installations with `rbenv` as homebrew tends to break the
> required Ruby dependencies
Expand All @@ -87,7 +77,7 @@ sidebar_position: 1
$ rbenv init
```

From the root directory of the `ios` repo do the following:
From the repository root, run:

```
$ rbenv install -s
Expand All @@ -105,7 +95,7 @@ sidebar_position: 1
```

If you see an error that a Ruby version is not installed, or that you should run
`bundle install`, re-run `rbenv install -s` and `bundle install` from the root of the `ios` repo.
`bundle install`, re-run `rbenv install -s` and `bundle install` from the repository root.

> **Note** Only run `bundle update` when you intend to upgrade the project's Ruby dependencies.
> It resolves the newest gem versions allowed by the `Gemfile` and rewrites `Gemfile.lock`, which
Expand All @@ -127,7 +117,7 @@ sidebar_position: 1
2. Run the app in the Simulator with the `Bitwarden` target for the Password Manager app or
`Authenticator` for the Authenticator app.

> [!TIP] To open the workspace in Xcode, just go to the root folder with the CLI and run:
> [!TIP] To open the workspace in Xcode, go to the repository root and run:
>
> ```sh
> open Bitwarden.xcworkspace
Expand Down