Native iOS app for Vauchi - privacy-focused contact card exchange.

• macOS
• Xcode (download from App Store or developer.apple.com)
• Rust (for building UniFFI bindings)

Run the setup script to configure Xcode:

./scripts/xcode-ide-setup.sh

This script will:

1. Verify Xcode installation
2. Accept the license agreement
3. Run first launch setup (installs required components)
4. Download iOS platform and simulators
5. Install Rust iOS targets for UniFFI builds

If you prefer manual setup or the script fails:

Option A - App Store:

• Open App Store, search "Xcode", install

Option B - Developer Portal (specific versions):

1. Go to https://developer.apple.com/download/all/
2. Sign in with Apple ID
3. Download Xcode .xip file
4. Extract and move to /Applications/Xcode.app

sudo xcodebuild -license accept

xcodebuild -runFirstLaunch

xcodebuild -downloadPlatform iOS

Or via Xcode: Settings → Components → iOS

rustup target add aarch64-apple-ios x86_64-apple-ios aarch64-apple-ios-sim

# Build for simulator
xcodebuild -scheme Vauchi -destination 'platform=iOS Simulator,name=iPhone 16' build

# Run tests
xcodebuild -scheme Vauchi -destination 'platform=iOS Simulator,name=iPhone 16' test

open Vauchi.xcodeproj

Then use Cmd+B to build, Cmd+R to run.

vauchi-ios/
├── Vauchi.xcodeproj      # Xcode project
├── Package.swift          # Swift Package Manager manifest
├── scripts/
│   └── setup-xcode.sh     # Development environment setup
├── Vauchi/
│   ├── VauchiApp.swift   # App entry point
│   ├── ContentView.swift  # Root view
│   ├── Views/
│   │   ├── HomeView.swift
│   │   ├── ContactsView.swift
│   │   ├── ContactDetailView.swift
│   │   ├── ExchangeView.swift
│   │   ├── QRScannerView.swift
│   │   ├── SettingsView.swift
│   │   └── SetupView.swift
│   ├── ViewModels/
│   │   └── VauchiViewModel.swift
│   └── Services/
│       ├── VauchiRepository.swift
│       └── KeychainService.swift
└── VauchiTests/
    ├── VauchiRepositoryTests.swift
    └── VauchiViewModelTests.swift

The iOS app follows MVVM architecture:

• Views: SwiftUI views for UI
• ViewModels: Business logic and state management
• Services: Data access (VauchiRepository wraps UniFFI bindings)

The app uses vauchi-mobile UniFFI bindings to call the Rust vauchi-core library for all cryptographic operations and data storage.

Install iOS simulators:

xcodebuild -downloadPlatform iOS

sudo xcodebuild -license accept

xcodebuild -runFirstLaunch

rustup target add aarch64-apple-ios x86_64-apple-ios aarch64-apple-ios-sim

TDD: Red→Green→Refactor. Test FIRST or delete code and restart.

Structure: src/ = production code only. tests/ = tests only. Siblings, not nested.

See CLAUDE.md for additional mandatory rules.

1. Check vauchi/docs for architecture decisions
2. Follow Apple's Human Interface Guidelines
3. Write tests for new features
4. Core library changes go to vauchi/code

MIT