# mak5er/aircard-ios architecture

> Architecture diagram of the GitHub repository mak5er/aircard-ios, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mak5er/aircard-ios
- Repository: https://github.com/mak5er/aircard-ios

## Overview

AirCard-iOS is an iOS customization app: users import or create artwork/themes, select device targets, and flash them to system caches through a paired device connection; wallpapers can trigger a respring. The SwiftUI app coordinates Wallet scanning and customization, passcode themes, PosterBoard imports, and pairing. Rust exposes the device-access and pairing functions through AirliftFFI. Some feature implementations are unsampled, so those branches follow README descriptions; edges are limited to documented or indexed references.

Main entry points: [`ios-app/AppViewModel.swift`](https://github.com/mak5er/aircard-ios/blob/main/ios-app/AppViewModel.swift) (App orchestration), [`rust-core/src/lib.rs`](https://github.com/mak5er/aircard-ios/blob/main/rust-core/src/lib.rs) (Airlift FFI), [`ios-app/ContentView.swift`](https://github.com/mak5er/aircard-ios/blob/main/ios-app/ContentView.swift) (SwiftUI interface), [`rust-core/src/exploit.rs`](https://github.com/mak5er/aircard-ios/blob/main/rust-core/src/exploit.rs) (AirTraffic exploit)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and workflow"]
  node_ui["SwiftUI interface<br/>[ContentView.swift]"]
  node_state["App orchestration<br/>[AppViewModel.swift]"]
end

subgraph group_custom["Customization features"]
  node_walletscan["Wallet scan parser"]
  node_walletart["Wallet artwork flash<br/>[AppViewModel.swift]"]
  node_photo["Card photo picker"]
  node_crop["Photo crop editor"]
  node_passtheme["Passcode themes<br/>[AppViewModel.swift]"]
  node_models["Theme and image models<br/>[Models.swift]"]
  node_tendiesui["Wallpaper interface<br/>[TendiesView.swift]"]
  node_tendies["Wallpaper import and flash"]
end

subgraph group_device["Pairing and device access"]
  node_pairui["Pairing controller"]
  node_network["Loopback status"]
  node_respring["NeoSpring respring"]
end

subgraph group_rust["Rust FFI core"]
  node_ffi["Airlift FFI<br/>[lib.rs]"]
  node_exploit["AirTraffic exploit<br/>[exploit.rs]"]
  node_pairhost["RPPairing host<br/>[pairing.rs]"]
  node_grappa["Grappa token helper<br/>[grappa.rs]"]
  node_ffiutil["FFI utilities<br/>[ffi_util.rs]"]
  node_logging["Logging<br/>[logging.rs]"]
end

node_user(("iPhone user"))
node_deviceos["iOS system services"]
node_bonjour["Settings pairing"]

node_user -->|"uses"| node_ui
node_ui -->|"updates"| node_state
node_ui -->|"shows"| node_tendiesui
node_ui -->|"presents"| node_photo
node_photo -->|"opens"| node_crop
node_state -->|"parses logs"| node_walletscan
node_state -->|"coordinates"| node_walletart
node_state -->|"coordinates"| node_passtheme
node_passtheme -.->|"uses layouts"| node_models
node_tendiesui -->|"starts flash"| node_state
node_state -->|"imports and flashes"| node_tendies
node_tendies -->|"calls FFI"| node_ffi
node_tendies -->|"injects wallpaper"| node_deviceos
node_state -->|"starts pairing"| node_pairui
node_pairui -->|"calls host FFI"| node_ffi
node_pairui -->|"advertises service"| node_bonjour
node_state -->|"checks loopback"| node_network
node_state -.->|"calls device FFI"| node_ffi
node_state -->|"triggers respring"| node_respring
node_ffi -->|"dispatches exploit"| node_exploit
node_ffi -->|"dispatches pairing"| node_pairhost
node_exploit -->|"uses utilities"| node_ffiutil
node_pairhost -->|"uses utilities"| node_ffiutil
node_exploit -->|"generates token"| node_grappa
node_ffi -.->|"initializes logging"| node_logging
node_exploit -->|"uses AirTraffic"| node_deviceos
node_pairhost -->|"provides pairing host"| node_bonjour

click node_ui "https://github.com/mak5er/aircard-ios/blob/main/ios-app/ContentView.swift"
click node_state "https://github.com/mak5er/aircard-ios/blob/main/ios-app/AppViewModel.swift"
click node_walletscan "https://github.com/mak5er/aircard-ios/blob/main/ios-app/WalletScanParser.swift"
click node_walletart "https://github.com/mak5er/aircard-ios/blob/main/ios-app/AppViewModel.swift"
click node_photo "https://github.com/mak5er/aircard-ios/blob/main/ios-app/CardPhotoPicker.swift"
click node_crop "https://github.com/mak5er/aircard-ios/blob/main/ios-app/CardPhotoCropView.swift"
click node_passtheme "https://github.com/mak5er/aircard-ios/blob/main/ios-app/AppViewModel.swift"
click node_models "https://github.com/mak5er/aircard-ios/blob/main/ios-app/Models.swift"
click node_tendiesui "https://github.com/mak5er/aircard-ios/blob/main/ios-app/TendiesView.swift"
click node_tendies "https://github.com/mak5er/aircard-ios/blob/main/ios-app/TendiesEngine.swift"
click node_pairui "https://github.com/mak5er/aircard-ios/blob/main/ios-app/PairingController.swift"
click node_network "https://github.com/mak5er/aircard-ios/blob/main/ios-app/NetworkStatus.swift"
click node_respring "https://github.com/mak5er/aircard-ios/blob/main/ios-app/RespringHelper.swift"
click node_ffi "https://github.com/mak5er/aircard-ios/blob/main/rust-core/src/lib.rs"
click node_exploit "https://github.com/mak5er/aircard-ios/blob/main/rust-core/src/exploit.rs"
click node_pairhost "https://github.com/mak5er/aircard-ios/blob/main/rust-core/src/pairing.rs"
click node_grappa "https://github.com/mak5er/aircard-ios/blob/main/rust-core/src/grappa.rs"
click node_ffiutil "https://github.com/mak5er/aircard-ios/blob/main/rust-core/src/ffi_util.rs"
click node_logging "https://github.com/mak5er/aircard-ios/blob/main/rust-core/src/logging.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_ui,node_state,node_user toneBlue
class node_walletscan,node_walletart,node_photo,node_crop,node_passtheme,node_models,node_tendiesui,node_tendies toneAmber
class node_pairui,node_network,node_respring toneMint
class node_ffi,node_exploit,node_pairhost,node_grappa,node_ffiutil,node_logging toneRose
class node_deviceos,node_bonjour toneIndigo
```

## Components

### App and workflow

- [SwiftUI interface](https://github.com/mak5er/aircard-ios/blob/main/ios-app/ContentView.swift): `ios-app/ContentView.swift`
- [App orchestration](https://github.com/mak5er/aircard-ios/blob/main/ios-app/AppViewModel.swift): `ios-app/AppViewModel.swift`

### Customization features

- [Wallet scan parser](https://github.com/mak5er/aircard-ios/blob/main/ios-app/WalletScanParser.swift): `ios-app/WalletScanParser.swift`
- [Wallet artwork flash](https://github.com/mak5er/aircard-ios/blob/main/ios-app/AppViewModel.swift): `ios-app/AppViewModel.swift`
- [Card photo picker](https://github.com/mak5er/aircard-ios/blob/main/ios-app/CardPhotoPicker.swift): `ios-app/CardPhotoPicker.swift`
- [Photo crop editor](https://github.com/mak5er/aircard-ios/blob/main/ios-app/CardPhotoCropView.swift): `ios-app/CardPhotoCropView.swift`
- [Passcode themes](https://github.com/mak5er/aircard-ios/blob/main/ios-app/AppViewModel.swift): `ios-app/AppViewModel.swift`
- [Theme and image models](https://github.com/mak5er/aircard-ios/blob/main/ios-app/Models.swift): `ios-app/Models.swift`
- [Wallpaper interface](https://github.com/mak5er/aircard-ios/blob/main/ios-app/TendiesView.swift): `ios-app/TendiesView.swift`
- [Wallpaper import and flash](https://github.com/mak5er/aircard-ios/blob/main/ios-app/TendiesEngine.swift): `ios-app/TendiesEngine.swift`

### Pairing and device access

- [Pairing controller](https://github.com/mak5er/aircard-ios/blob/main/ios-app/PairingController.swift): `ios-app/PairingController.swift`
- [Loopback status](https://github.com/mak5er/aircard-ios/blob/main/ios-app/NetworkStatus.swift): `ios-app/NetworkStatus.swift`
- [NeoSpring respring](https://github.com/mak5er/aircard-ios/blob/main/ios-app/RespringHelper.swift): `ios-app/RespringHelper.swift`

### Rust FFI core

- [Airlift FFI](https://github.com/mak5er/aircard-ios/blob/main/rust-core/src/lib.rs): `rust-core/src/lib.rs`
- [AirTraffic exploit](https://github.com/mak5er/aircard-ios/blob/main/rust-core/src/exploit.rs): `rust-core/src/exploit.rs`
- [RPPairing host](https://github.com/mak5er/aircard-ios/blob/main/rust-core/src/pairing.rs): `rust-core/src/pairing.rs`
- [Grappa token helper](https://github.com/mak5er/aircard-ios/blob/main/rust-core/src/grappa.rs): `rust-core/src/grappa.rs`
- [FFI utilities](https://github.com/mak5er/aircard-ios/blob/main/rust-core/src/ffi_util.rs): `rust-core/src/ffi_util.rs`
- [Logging](https://github.com/mak5er/aircard-ios/blob/main/rust-core/src/logging.rs): `rust-core/src/logging.rs`

### Other components

- **iPhone user**
- **iOS system services**
- **Settings pairing**

## Connections

- iPhone user → SwiftUI interface: uses (evidence: `README.md`)
- SwiftUI interface → App orchestration: updates (evidence: `ios-app/ContentView.swift`)
- SwiftUI interface → Wallpaper interface: shows (evidence: `ios-app/ContentView.swift`)
- SwiftUI interface → Card photo picker: presents (evidence: `ios-app/ContentView.swift`)
- Card photo picker → Photo crop editor: opens (evidence: `ios-app/CardPhotoPicker.swift`)
- App orchestration → Wallet scan parser: parses logs (evidence: `ios-app/AppViewModel.swift`)
- App orchestration → Wallet artwork flash: coordinates (evidence: `README.md`)
- App orchestration → Passcode themes: coordinates (evidence: `README.md`)
- Passcode themes → Theme and image models: uses layouts
- Wallpaper interface → App orchestration: starts flash (evidence: `ios-app/TendiesView.swift`)
- App orchestration → Wallpaper import and flash: imports and flashes (evidence: `ios-app/AppViewModel.swift`)
- Wallpaper import and flash → Airlift FFI: calls FFI (evidence: `ios-app/TendiesEngine.swift`)
- Wallpaper import and flash → iOS system services: injects wallpaper (evidence: `README.md`)
- App orchestration → Pairing controller: starts pairing (evidence: `ios-app/AppViewModel.swift`)
- Pairing controller → Airlift FFI: calls host FFI (evidence: `ios-app/PairingController.swift`)
- Pairing controller → Settings pairing: advertises service (evidence: `ios-app/PairingController.swift`)
- App orchestration → Loopback status: checks loopback (evidence: `ios-app/AppViewModel.swift`)
- App orchestration → Airlift FFI: calls device FFI
- App orchestration → NeoSpring respring: triggers respring (evidence: `README.md`)
- Airlift FFI → AirTraffic exploit: dispatches exploit (evidence: `rust-core/src/lib.rs`)
- Airlift FFI → RPPairing host: dispatches pairing (evidence: `rust-core/src/lib.rs`)
- AirTraffic exploit → FFI utilities: uses utilities (evidence: `rust-core/src/exploit.rs`)
- RPPairing host → FFI utilities: uses utilities (evidence: `rust-core/src/pairing.rs`)
- AirTraffic exploit → Grappa token helper: generates token (evidence: `rust-core/src/exploit.rs`)
- Airlift FFI → Logging: initializes logging (evidence: `rust-core/src/lib.rs`)
- AirTraffic exploit → iOS system services: uses AirTraffic (evidence: `README.md`)
- RPPairing host → Settings pairing: provides pairing host (evidence: `rust-core/src/pairing.rs`)
