aliasvault/docs/mobile-apps/ios/build-from-source.md

layout, title, parent, grand_parent, nav_order

layout	title	parent	grand_parent	nav_order
default	Build from Source	iOS App	Mobile Apps	2

Building AliasVault iOS App from Source

This guide explains how to build and install the AliasVault iOS app from source code using React Native.

Prerequisites

• macOS with Xcode installed (required for building iOS apps)
• Homebrew installed
• Node.js installed
• CocoaPods installed (brew install cocoapods)
• Git to clone the repository
• Xcode Command Line Tools (xcode-select --install)
• An Apple developer account for signing and installing on real devices (optional for simulator)

Building the iOS App

1. Clone the repository:

git clone https://github.com/aliasvault/aliasvault.git

2. Navigate to the mobile app directory:

cd aliasvault/apps/mobile-app

3. Install JavaScript dependencies:

npm install

4. Install iOS native dependencies via CocoaPods:

npx pod-install

5. Open the iOS workspace in Xcode:

./apps/mobile-app/ios/AliasVault.xcworkspace

6. In Xcode, select a simulator or a connected physical device.

7. Click Run (▶️) in Xcode to build and launch the app.

Notes

• If you're running on a physical iPhone, you'll need to configure code signing with your Apple ID in Xcode under Signing & Capabilities.