Mirror: This repo is a read-only mirror of gitlab.com/vauchi/ios. Please open issues and merge requests there.

Note

You're early — and that's the point. Vauchi is pre-alpha and under heavy development: not yet ready for production, and APIs may change without notice. If you're here now, you can help shape it — try it, break it, and tell us what's missing.

Vauchi iOS

Native iOS app for Vauchi - living contact cards, exchanged in person.

Prerequisites

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

Quick Setup

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

Manual Setup

If you prefer manual setup or the script fails:

1. Install Xcode

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

2. Accept License Agreement

sudo xcodebuild -license accept

3. Install Components

xcodebuild -runFirstLaunch

4. Install iOS Platform

xcodebuild -downloadPlatform iOS

Or via Xcode: Settings → Components → iOS

5. Install Rust iOS Targets (for UniFFI)

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

Building

Command Line

# 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

Xcode

open Vauchi.xcodeproj

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

Project Structure

Vauchi.xcodeproj plus three source roots: Vauchi/ (app code: Views/, ViewModels/, Services/, CoreUI/), VauchiTests/ (unit tests), and scripts/ (setup + signing helpers). Run ls for the live tree — this README deliberately carries no file inventory.

Architecture

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-platform UniFFI bindings to call the Rust vauchi-core library for all cryptographic operations and data storage.

Troubleshooting

"No available devices matched the request"

Install iOS simulators:

xcodebuild -downloadPlatform iOS

"You have not agreed to the Xcode license"

sudo xcodebuild -license accept

"CoreSimulator.framework not found"

xcodebuild -runFirstLaunch

Rust targets missing

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

Related Repositories

Repository	Description
vauchi/core	Core Rust library (source of UniFFI bindings)
vauchi/android	Android app (Kotlin/Compose)
vauchi/docs	Documentation
vauchi/scripts	Build scripts and workspace tools

⚠️ Mandatory Development Rules

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.

Contributing

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

Support the Project

Vauchi is open source and community-funded — no VC money, no data harvesting.

• GitHub Sponsors
• Liberapay
• Supporters for sponsorship tiers

License

GPL-3.0-or-later