From c0dd653fc9e31da3dc4d282f55873791fa9071cc Mon Sep 17 00:00:00 2001
From: Tony Giorgio <101225832+TonyGiorgio@users.noreply.github.com>
Date: Sat, 10 Jan 2026 11:17:42 -0600
Subject: [PATCH 01/11] feat(ios): add TTS support using ONNX Runtime

- Add iOS-specific ort dependencies and build configuration
- Enable TTS module for iOS (was desktop-only)
- Add iOS-specific path handling for model storage
- Build ONNX Runtime 1.22.2 from source with all dependencies statically linked
- Add retry logic and combined static library creation
- Update GitHub Actions to build and cache ONNX Runtime for iOS

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
---
 .github/workflows/mobile-build.yml            |  65 ++++-
 frontend/bun.lock                             |   1 +
 frontend/src-tauri/.gitignore                 |   7 +
 frontend/src-tauri/Cargo.toml                 |  17 ++
 frontend/src-tauri/build.rs                   |  30 ++
 .../scripts/build-ios-onnxruntime.sh          | 259 ++++++++++++++++++
 .../scripts/setup-ios-onnxruntime.sh          |  78 ++++++
 frontend/src-tauri/src/lib.rs                 |  41 ++-
 frontend/src-tauri/src/tts.rs                 |  23 +-
 9 files changed, 513 insertions(+), 8 deletions(-)
 create mode 100755 frontend/src-tauri/scripts/build-ios-onnxruntime.sh
 create mode 100755 frontend/src-tauri/scripts/setup-ios-onnxruntime.sh

diff --git a/.github/workflows/mobile-build.yml b/.github/workflows/mobile-build.yml
index 40e461ae..27681a3e 100644
--- a/.github/workflows/mobile-build.yml
+++ b/.github/workflows/mobile-build.yml
@@ -53,6 +53,63 @@ jobs:
         working-directory: ./frontend
         run: bun install
 
+      - name: Cache ONNX Runtime iOS build
+        uses: actions/cache@v4
+        id: cache-onnxruntime
+        with:
+          path: |
+            frontend/src-tauri/onnxruntime-ios
+            frontend/src-tauri/onnxruntime-build
+          key: onnxruntime-ios-built-1.22.2-v1
+          restore-keys: |
+            onnxruntime-ios-built-1.22.2-
+
+      - name: Build ONNX Runtime for iOS from source
+        if: steps.cache-onnxruntime.outputs.cache-hit != 'true'
+        working-directory: ./frontend/src-tauri
+        run: |
+          chmod +x scripts/build-ios-onnxruntime.sh
+          ./scripts/build-ios-onnxruntime.sh 1.22.2
+        timeout-minutes: 90
+
+      - name: Verify ONNX Runtime files
+        run: |
+          echo "Checking ONNX Runtime xcframework..."
+          ls -la ${{ github.workspace }}/frontend/src-tauri/onnxruntime-ios/onnxruntime.xcframework/
+          ls -la ${{ github.workspace }}/frontend/src-tauri/onnxruntime-ios/onnxruntime.xcframework/ios-arm64/
+          echo ""
+          echo "Library info:"
+          file ${{ github.workspace }}/frontend/src-tauri/onnxruntime-ios/onnxruntime.xcframework/ios-arm64/libonnxruntime.a
+          echo ""
+          echo "Checking for Abseil symbols (should be included):"
+          nm ${{ github.workspace }}/frontend/src-tauri/onnxruntime-ios/onnxruntime.xcframework/ios-arm64/libonnxruntime.a 2>/dev/null | grep -i "absl" | head -20 || echo "No abseil symbols found (they may be internal)"
+
+      - name: Configure Cargo for iOS ONNX Runtime
+        run: |
+          # Create cargo config with absolute paths for iOS builds
+          # This overrides ort-sys's build script to use our built-from-source library
+          WORKSPACE="${{ github.workspace }}"
+          mkdir -p "${WORKSPACE}/frontend/src-tauri/.cargo"
+          cat > "${WORKSPACE}/frontend/src-tauri/.cargo/config.toml" << EOF
+          # Auto-generated cargo config for iOS ONNX Runtime linking
+          # Uses absolute paths because xcodebuild may run cargo from different directories
+          
+          [target.aarch64-apple-ios.onnxruntime]
+          rustc-link-search = ["${WORKSPACE}/frontend/src-tauri/onnxruntime-ios/onnxruntime.xcframework/ios-arm64"]
+          rustc-link-lib = ["static=onnxruntime"]
+          
+          [target.aarch64-apple-ios-sim.onnxruntime]
+          rustc-link-search = ["${WORKSPACE}/frontend/src-tauri/onnxruntime-ios/onnxruntime.xcframework/ios-arm64-simulator"]
+          rustc-link-lib = ["static=onnxruntime"]
+          
+          [target.x86_64-apple-ios.onnxruntime]
+          rustc-link-search = ["${WORKSPACE}/frontend/src-tauri/onnxruntime-ios/onnxruntime.xcframework/ios-arm64-simulator"]
+          rustc-link-lib = ["static=onnxruntime"]
+          EOF
+          
+          echo "Generated cargo config:"
+          cat "${WORKSPACE}/frontend/src-tauri/.cargo/config.toml"
+
       - name: Setup Xcode
         uses: maxim-lobanov/setup-xcode@v1
         with:
@@ -89,6 +146,8 @@ jobs:
           VITE_OPEN_SECRET_API_URL: https://enclave.trymaple.ai
           VITE_MAPLE_BILLING_API_URL: https://billing.opensecret.cloud
           VITE_CLIENT_ID: ba5a14b5-d915-47b1-b7b1-afda52bc5fc6
+          # ONNX Runtime location for ort-sys crate
+          ORT_LIB_LOCATION: ${{ github.workspace }}/frontend/src-tauri/onnxruntime-ios/onnxruntime.xcframework/ios-arm64
 
       - name: Upload iOS App
         uses: actions/upload-artifact@v4
@@ -99,7 +158,11 @@ jobs:
           retention-days: 5
 
       - name: Submit to TestFlight
-        if: github.event_name == 'push' && github.ref == 'refs/heads/master'
+        # TODO: Remove ios-tts condition after PR #378 is merged
+        # For this PR, we want to test TestFlight submissions on every build
+        if: |
+          (github.event_name == 'push' && github.ref == 'refs/heads/master') ||
+          (github.event_name == 'pull_request' && github.head_ref == 'ios-tts')
         run: |
           # Find the actual path of the IPA file
           IPA_PATH=$(find frontend/src-tauri/gen/apple/build -name "*.ipa" | head -n 1)
diff --git a/frontend/bun.lock b/frontend/bun.lock
index acf319d9..847fabcd 100644
--- a/frontend/bun.lock
+++ b/frontend/bun.lock
@@ -1,5 +1,6 @@
 {
   "lockfileVersion": 1,
+  "configVersion": 0,
   "workspaces": {
     "": {
       "name": "maple",
diff --git a/frontend/src-tauri/.gitignore b/frontend/src-tauri/.gitignore
index 502406b4..332ca1f9 100644
--- a/frontend/src-tauri/.gitignore
+++ b/frontend/src-tauri/.gitignore
@@ -2,3 +2,10 @@
 # will have compiled files and executables
 /target/
 /gen/schemas
+
+# ONNX Runtime iOS (built from source)
+/onnxruntime-ios/
+/onnxruntime-build/
+
+# Generated cargo config for iOS builds
+/.cargo/
diff --git a/frontend/src-tauri/Cargo.toml b/frontend/src-tauri/Cargo.toml
index 4bfb6eb8..7a980a37 100644
--- a/frontend/src-tauri/Cargo.toml
+++ b/frontend/src-tauri/Cargo.toml
@@ -53,5 +53,22 @@ futures-util = "0.3"
 dirs = "5.0"
 sha2 = "0.10"
 
+[target.'cfg(target_os = "ios")'.dependencies]
+# TTS dependencies (Supertonic) - iOS
+# We build ONNX Runtime 1.22.2 from source for iOS (see scripts/build-ios-onnxruntime.sh)
+# We disable download-binaries and copy-dylibs since we link our own xcframework
+# Need "std" for Error trait impl and file operations, "ndarray" for tensor creation
+ort = { version = "2.0.0-rc.10", default-features = false, features = ["std", "ndarray"] }
+ndarray = { version = "0.16" }
+rand = "0.8"
+rand_distr = "0.4"
+hound = "3.5"
+unicode-normalization = "0.1"
+regex = "1.10"
+reqwest = { version = "0.12", features = ["stream"] }
+futures-util = "0.3"
+dirs = "5.0"
+sha2 = "0.10"
+
 [target.'cfg(target_os = "android")'.dependencies]
 openssl = { version = "0.10", default-features = false, features = ["vendored"] }
diff --git a/frontend/src-tauri/build.rs b/frontend/src-tauri/build.rs
index d860e1e6..ecad17e9 100644
--- a/frontend/src-tauri/build.rs
+++ b/frontend/src-tauri/build.rs
@@ -1,3 +1,33 @@
 fn main() {
+    // iOS-specific build configuration for ONNX Runtime
+    #[cfg(target_os = "ios")]
+    {
+        // Get the path to the ONNX Runtime xcframework
+        let manifest_dir = std::env::var("CARGO_MANIFEST_DIR").unwrap();
+        let ort_dir = format!("{}/onnxruntime-ios", manifest_dir);
+        
+        // Check if building for simulator or device
+        let target = std::env::var("TARGET").unwrap_or_default();
+        let lib_path = if target.contains("sim") || target.contains("x86_64") {
+            format!("{}/onnxruntime.xcframework/ios-arm64_x86_64-simulator", ort_dir)
+        } else {
+            format!("{}/onnxruntime.xcframework/ios-arm64", ort_dir)
+        };
+        
+        // Tell cargo where to find the ONNX Runtime static library
+        println!("cargo:rustc-link-search=native={}", lib_path);
+        println!("cargo:rustc-link-lib=static=onnxruntime");
+        
+        // Link required iOS frameworks
+        println!("cargo:rustc-link-lib=framework=Foundation");
+        println!("cargo:rustc-link-lib=framework=Accelerate");
+        
+        // Set ORT_LIB_LOCATION for the ort crate
+        println!("cargo:rustc-env=ORT_LIB_LOCATION={}", ort_dir);
+        
+        // Rerun if the onnxruntime directory changes
+        println!("cargo:rerun-if-changed={}", ort_dir);
+    }
+    
     tauri_build::build()
 }
diff --git a/frontend/src-tauri/scripts/build-ios-onnxruntime.sh b/frontend/src-tauri/scripts/build-ios-onnxruntime.sh
new file mode 100755
index 00000000..fb1d2408
--- /dev/null
+++ b/frontend/src-tauri/scripts/build-ios-onnxruntime.sh
@@ -0,0 +1,259 @@
+#!/bin/bash
+# Build ONNX Runtime from source for iOS
+# This creates a static library with all dependencies (including Abseil) statically linked
+#
+# Prerequisites:
+# - macOS with Xcode installed
+# - CMake 3.26+
+# - Python 3.8+
+# - Git
+#
+# Usage: ./build-ios-onnxruntime.sh [version]
+# Example: ./build-ios-onnxruntime.sh 1.20.1
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+TAURI_DIR="$(dirname "$SCRIPT_DIR")"
+# Use latest 1.22.2 - older versions have Eigen hash mismatch issues with GitLab
+ORT_VERSION="${1:-1.22.2}"
+BUILD_DIR="${TAURI_DIR}/onnxruntime-build"
+OUTPUT_DIR="${TAURI_DIR}/onnxruntime-ios"
+XCFRAMEWORK_DIR="${OUTPUT_DIR}/onnxruntime.xcframework"
+
+# Minimum iOS version to support
+IOS_DEPLOYMENT_TARGET="13.0"
+
+echo "========================================"
+echo "Building ONNX Runtime ${ORT_VERSION} for iOS"
+echo "========================================"
+echo "Build directory: ${BUILD_DIR}"
+echo "Output directory: ${OUTPUT_DIR}"
+echo "iOS deployment target: ${IOS_DEPLOYMENT_TARGET}"
+echo ""
+
+# Check prerequisites
+command -v cmake >/dev/null 2>&1 || { echo "Error: cmake is required but not installed."; exit 1; }
+command -v python3 >/dev/null 2>&1 || { echo "Error: python3 is required but not installed."; exit 1; }
+command -v git >/dev/null 2>&1 || { echo "Error: git is required but not installed."; exit 1; }
+command -v xcodebuild >/dev/null 2>&1 || { echo "Error: Xcode is required but not installed."; exit 1; }
+
+# Check if output already exists
+if [ -d "$XCFRAMEWORK_DIR" ]; then
+    echo "ONNX Runtime xcframework already exists at $XCFRAMEWORK_DIR"
+    echo "To rebuild, remove the directory first: rm -rf $OUTPUT_DIR"
+    exit 0
+fi
+
+# Create build directory
+mkdir -p "$BUILD_DIR"
+cd "$BUILD_DIR"
+
+# Clone ONNX Runtime if not already cloned (with retry for transient network errors)
+clone_with_retry() {
+    local max_attempts=3
+    local attempt=1
+    while [ $attempt -le $max_attempts ]; do
+        echo "Attempt $attempt of $max_attempts..."
+        if git clone --depth 1 --branch "v${ORT_VERSION}" --recursive https://github.com/microsoft/onnxruntime.git; then
+            return 0
+        fi
+        echo "Clone failed, waiting 10 seconds before retry..."
+        sleep 10
+        attempt=$((attempt + 1))
+    done
+    echo "Failed to clone after $max_attempts attempts"
+    return 1
+}
+
+submodule_update_with_retry() {
+    local max_attempts=3
+    local attempt=1
+    while [ $attempt -le $max_attempts ]; do
+        echo "Attempt $attempt of $max_attempts..."
+        if git submodule update --init --recursive; then
+            return 0
+        fi
+        echo "Submodule update failed, waiting 10 seconds before retry..."
+        sleep 10
+        attempt=$((attempt + 1))
+    done
+    echo "Failed to update submodules after $max_attempts attempts"
+    return 1
+}
+
+if [ ! -d "onnxruntime" ]; then
+    echo "Cloning ONNX Runtime repository..."
+    clone_with_retry
+else
+    echo "ONNX Runtime repository already cloned"
+    cd onnxruntime
+    git fetch --tags
+    git checkout "v${ORT_VERSION}"
+    submodule_update_with_retry
+    cd ..
+fi
+
+cd onnxruntime
+
+# Common cmake extra defines to work around compatibility issues
+# CMAKE_POLICY_VERSION_MINIMUM=3.5 fixes nsync compatibility with newer CMake
+CMAKE_EXTRA_DEFINES="CMAKE_POLICY_VERSION_MINIMUM=3.5"
+
+# Build for iOS device (arm64)
+echo ""
+echo "========================================"
+echo "Building for iOS device (arm64)..."
+echo "========================================"
+
+./build.sh \
+    --config Release \
+    --use_xcode \
+    --ios \
+    --apple_sysroot iphoneos \
+    --osx_arch arm64 \
+    --apple_deploy_target "${IOS_DEPLOYMENT_TARGET}" \
+    --parallel \
+    --skip_tests \
+    --compile_no_warning_as_error \
+    --cmake_extra_defines "${CMAKE_EXTRA_DEFINES}"
+
+# ONNX Runtime builds multiple static libraries, we need to combine them
+# The libraries are in build/iOS/Release/Release-iphoneos/
+IOS_ARM64_BUILD_DIR="build/iOS/Release/Release-iphoneos"
+IOS_ARM64_COMBINED_LIB="${IOS_ARM64_BUILD_DIR}/libonnxruntime_combined.a"
+
+echo ""
+echo "Combining iOS arm64 static libraries..."
+
+# Find all ONNX Runtime static libraries and combine them
+# We need: onnxruntime_*, onnx*, protobuf-lite, re2, cpuinfo, abseil libs, etc.
+IOS_ARM64_LIBS=$(find build/iOS/Release -name "*.a" -path "*Release-iphoneos*" -type f | grep -v "gtest\|gmock" | sort -u)
+
+if [ -z "$IOS_ARM64_LIBS" ]; then
+    echo "Error: Could not find iOS arm64 static libraries"
+    exit 1
+fi
+
+echo "Found libraries to combine:"
+echo "$IOS_ARM64_LIBS" | head -20
+echo "..."
+
+# Use libtool to combine all static libraries into one
+libtool -static -o "$IOS_ARM64_COMBINED_LIB" $IOS_ARM64_LIBS
+
+if [ ! -f "$IOS_ARM64_COMBINED_LIB" ]; then
+    echo "Error: Failed to create combined library"
+    exit 1
+fi
+
+IOS_ARM64_LIB="$IOS_ARM64_COMBINED_LIB"
+echo "Created combined library: $IOS_ARM64_LIB"
+ls -lh "$IOS_ARM64_LIB"
+
+# SKIP SIMULATOR BUILD for now
+# The simulator build has a bug where it tries to link against the wrong iconv library:
+# "ld: building for 'iOS-simulator', but linking in dylib built for 'iOS'"
+# For TestFlight/App Store deployment, we only need the device build anyway.
+# Local development can use the desktop version or a physical device.
+echo ""
+echo "Skipping iOS simulator build (known ONNX Runtime CMake bug with libiconv)"
+echo "Device build is sufficient for TestFlight deployment"
+IOS_SIM_ARM64_LIB=""
+
+# Create output directories
+echo ""
+echo "========================================"
+echo "Creating xcframework..."
+echo "========================================"
+
+mkdir -p "${OUTPUT_DIR}"
+mkdir -p "${XCFRAMEWORK_DIR}/ios-arm64"
+mkdir -p "${XCFRAMEWORK_DIR}/ios-arm64-simulator"
+mkdir -p "${XCFRAMEWORK_DIR}/Headers"
+
+# Copy the device library
+cp "$IOS_ARM64_LIB" "${XCFRAMEWORK_DIR}/ios-arm64/libonnxruntime.a"
+
+# Copy the simulator library (arm64 only for now)
+if [ -n "$IOS_SIM_ARM64_LIB" ] && [ -f "$IOS_SIM_ARM64_LIB" ]; then
+    cp "$IOS_SIM_ARM64_LIB" "${XCFRAMEWORK_DIR}/ios-arm64-simulator/libonnxruntime.a"
+else
+    echo "Warning: No simulator library available"
+fi
+
+# Copy headers
+HEADER_DIR=$(find build -name "onnxruntime_c_api.h" -type f | head -n 1 | xargs dirname)
+if [ -n "$HEADER_DIR" ]; then
+    cp "${HEADER_DIR}"/*.h "${XCFRAMEWORK_DIR}/Headers/" 2>/dev/null || true
+fi
+
+# Also copy headers from include directory
+if [ -d "include/onnxruntime/core/session" ]; then
+    cp include/onnxruntime/core/session/*.h "${XCFRAMEWORK_DIR}/Headers/" 2>/dev/null || true
+fi
+
+# Create Info.plist for xcframework
+cat > "${XCFRAMEWORK_DIR}/Info.plist" << 'PLIST'
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>AvailableLibraries</key>
+    <array>
+        <dict>
+            <key>HeadersPath</key>
+            <string>Headers</string>
+            <key>LibraryIdentifier</key>
+            <string>ios-arm64</string>
+            <key>LibraryPath</key>
+            <string>libonnxruntime.a</string>
+            <key>SupportedArchitectures</key>
+            <array>
+                <string>arm64</string>
+            </array>
+            <key>SupportedPlatform</key>
+            <string>ios</string>
+        </dict>
+        <dict>
+            <key>HeadersPath</key>
+            <string>Headers</string>
+            <key>LibraryIdentifier</key>
+            <string>ios-arm64-simulator</string>
+            <key>LibraryPath</key>
+            <string>libonnxruntime.a</string>
+            <key>SupportedArchitectures</key>
+            <array>
+                <string>arm64</string>
+            </array>
+            <key>SupportedPlatform</key>
+            <string>ios</string>
+            <key>SupportedPlatformVariant</key>
+            <string>simulator</string>
+        </dict>
+    </array>
+    <key>CFBundlePackageType</key>
+    <string>XFWK</string>
+    <key>XCFrameworkFormatVersion</key>
+    <string>1.0</string>
+</dict>
+</plist>
+PLIST
+
+echo ""
+echo "========================================"
+echo "Build complete!"
+echo "========================================"
+echo ""
+echo "ONNX Runtime xcframework created at:"
+echo "  ${XCFRAMEWORK_DIR}"
+echo ""
+echo "Contents:"
+ls -la "${XCFRAMEWORK_DIR}"
+echo ""
+echo "Static library sizes:"
+ls -lh "${XCFRAMEWORK_DIR}/ios-arm64/libonnxruntime.a"
+ls -lh "${XCFRAMEWORK_DIR}/ios-arm64-simulator/libonnxruntime.a" 2>/dev/null || echo "No simulator library"
+echo ""
+echo "Verifying library contains key symbols:"
+nm "${XCFRAMEWORK_DIR}/ios-arm64/libonnxruntime.a" 2>/dev/null | grep -i "OrtCreateSession" | head -3 || echo "Symbols check skipped"
diff --git a/frontend/src-tauri/scripts/setup-ios-onnxruntime.sh b/frontend/src-tauri/scripts/setup-ios-onnxruntime.sh
new file mode 100755
index 00000000..88e0e491
--- /dev/null
+++ b/frontend/src-tauri/scripts/setup-ios-onnxruntime.sh
@@ -0,0 +1,78 @@
+#!/bin/bash
+# Setup ONNX Runtime for iOS builds
+# This script downloads pre-built ONNX Runtime xcframework from HuggingFace
+# or builds from source if needed.
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+TAURI_DIR="$(dirname "$SCRIPT_DIR")"
+ORT_VERSION="${ORT_VERSION:-1.20.1}"
+ORT_DIR="$TAURI_DIR/onnxruntime-ios"
+XCFRAMEWORK_DIR="$ORT_DIR/onnxruntime.xcframework"
+
+echo "Setting up ONNX Runtime $ORT_VERSION for iOS..."
+echo "Target directory: $ORT_DIR"
+
+# Check if already downloaded
+if [ -d "$XCFRAMEWORK_DIR" ]; then
+    echo "ONNX Runtime xcframework already exists at $XCFRAMEWORK_DIR"
+    echo "To re-download, remove the directory first: rm -rf $ORT_DIR"
+    exit 0
+fi
+
+# Create directory
+mkdir -p "$ORT_DIR"
+
+# Download pre-built xcframework from HuggingFace
+# Repository: https://huggingface.co/csukuangfj/ios-onnxruntime
+HF_BASE_URL="https://huggingface.co/csukuangfj/ios-onnxruntime/resolve/main"
+
+echo "Downloading ONNX Runtime $ORT_VERSION xcframework from HuggingFace..."
+
+# Download the xcframework directory structure
+# The structure is:
+# onnxruntime.xcframework/
+#   Info.plist
+#   Headers/
+#     cpu_provider_factory.h
+#     onnxruntime_c_api.h
+#     onnxruntime_cxx_api.h
+#     onnxruntime_cxx_inline.h
+#   ios-arm64/
+#     onnxruntime.a
+#   ios-arm64_x86_64-simulator/
+#     onnxruntime.a
+
+mkdir -p "$XCFRAMEWORK_DIR/Headers"
+mkdir -p "$XCFRAMEWORK_DIR/ios-arm64"
+mkdir -p "$XCFRAMEWORK_DIR/ios-arm64_x86_64-simulator"
+
+echo "Downloading Info.plist..."
+curl -L -o "$XCFRAMEWORK_DIR/Info.plist" \
+    "$HF_BASE_URL/$ORT_VERSION/onnxruntime.xcframework/Info.plist"
+
+echo "Downloading headers..."
+for header in cpu_provider_factory.h onnxruntime_c_api.h onnxruntime_cxx_api.h onnxruntime_cxx_inline.h; do
+    curl -L -o "$XCFRAMEWORK_DIR/Headers/$header" \
+        "$HF_BASE_URL/$ORT_VERSION/onnxruntime.xcframework/Headers/$header"
+done
+
+echo "Downloading iOS arm64 static library (this may take a while)..."
+curl -L -o "$XCFRAMEWORK_DIR/ios-arm64/libonnxruntime.a" \
+    "$HF_BASE_URL/$ORT_VERSION/onnxruntime.xcframework/ios-arm64/onnxruntime.a"
+
+echo "Downloading iOS simulator static library (this may take a while)..."
+curl -L -o "$XCFRAMEWORK_DIR/ios-arm64_x86_64-simulator/libonnxruntime.a" \
+    "$HF_BASE_URL/$ORT_VERSION/onnxruntime.xcframework/ios-arm64_x86_64-simulator/onnxruntime.a"
+
+echo ""
+echo "ONNX Runtime xcframework downloaded successfully!"
+echo "Location: $XCFRAMEWORK_DIR"
+echo ""
+echo "Contents:"
+ls -la "$XCFRAMEWORK_DIR"
+echo ""
+echo "Static library sizes:"
+ls -lh "$XCFRAMEWORK_DIR/ios-arm64/libonnxruntime.a"
+ls -lh "$XCFRAMEWORK_DIR/ios-arm64_x86_64-simulator/libonnxruntime.a"
diff --git a/frontend/src-tauri/src/lib.rs b/frontend/src-tauri/src/lib.rs
index 2deadf0e..a9cee65f 100644
--- a/frontend/src-tauri/src/lib.rs
+++ b/frontend/src-tauri/src/lib.rs
@@ -3,7 +3,8 @@ use tauri_plugin_deep_link::DeepLinkExt;
 
 mod pdf_extractor;
 mod proxy;
-#[cfg(desktop)]
+// TTS is available on desktop and iOS (not Android)
+#[cfg(any(desktop, target_os = "ios"))]
 mod tts;
 
 #[cfg(desktop)]
@@ -240,6 +241,7 @@ pub fn run() {
         })
         .plugin(tauri_plugin_updater::Builder::new().build());
 
+    // Mobile (iOS and Android) configuration
     #[cfg(not(desktop))]
     let mut builder = tauri::Builder::default()
         .plugin(
@@ -258,7 +260,14 @@ pub fn run() {
         builder = builder.plugin(tauri_plugin_sign_in_with_apple::init());
     }
 
-    #[cfg(not(desktop))]
+    // Add TTS state management for iOS
+    #[cfg(all(not(desktop), target_os = "ios"))]
+    {
+        builder = builder.manage(tts::TTSState::new());
+    }
+
+    // Android-specific configuration (no TTS)
+    #[cfg(all(not(desktop), target_os = "android"))]
     let app = builder
         .invoke_handler(tauri::generate_handler![
             pdf_extractor::extract_document_content,
@@ -279,6 +288,34 @@ pub fn run() {
         })
         .plugin(tauri_plugin_updater::Builder::new().build());
 
+    // iOS-specific configuration (with TTS)
+    #[cfg(all(not(desktop), target_os = "ios"))]
+    let app = builder
+        .invoke_handler(tauri::generate_handler![
+            pdf_extractor::extract_document_content,
+            tts::tts_get_status,
+            tts::tts_download_models,
+            tts::tts_load_models,
+            tts::tts_synthesize,
+            tts::tts_unload_models,
+            tts::tts_delete_models,
+        ])
+        .setup(|app| {
+            // Set up the deep link handler for mobile
+            let app_handle = app.handle().clone();
+
+            // Register deep link handler - note that iOS does not support runtime registration
+            // but the handler for incoming URLs still works
+            app.deep_link().on_open_url(move |event| {
+                if let Some(url) = event.urls().first() {
+                    handle_deep_link_event(url.as_ref(), &app_handle);
+                }
+            });
+
+            Ok(())
+        })
+        .plugin(tauri_plugin_updater::Builder::new().build());
+
     app.run(tauri::generate_context!())
         .expect("error while running tauri application");
 }
diff --git a/frontend/src-tauri/src/tts.rs b/frontend/src-tauri/src/tts.rs
index 5c5f2566..bfd5ab4a 100644
--- a/frontend/src-tauri/src/tts.rs
+++ b/frontend/src-tauri/src/tts.rs
@@ -612,11 +612,24 @@ impl TextToSpeech {
 }
 
 fn get_tts_models_dir() -> Result<PathBuf> {
-    let data_dir = dirs::data_local_dir()
-        .context("Failed to get local data directory")?
-        .join("cloud.opensecret.maple")
-        .join("tts_models");
-    Ok(data_dir)
+    // On iOS, we need to use a different approach since dirs::data_local_dir() may not work
+    #[cfg(target_os = "ios")]
+    {
+        // On iOS, use the app's Documents directory which is accessible and persists
+        // NSHomeDirectory() + /Documents/tts_models
+        let home = std::env::var("HOME").context("Failed to get HOME directory on iOS")?;
+        let data_dir = PathBuf::from(home).join("Documents").join("tts_models");
+        return Ok(data_dir);
+    }
+    
+    #[cfg(not(target_os = "ios"))]
+    {
+        let data_dir = dirs::data_local_dir()
+            .context("Failed to get local data directory")?
+            .join("cloud.opensecret.maple")
+            .join("tts_models");
+        Ok(data_dir)
+    }
 }
 
 fn load_voice_style(models_dir: &Path) -> Result<Style> {

From d5953c7e2e82cc1d66cc8717d4d33bd3fe63e282 Mon Sep 17 00:00:00 2001
From: Tony Giorgio <101225832+TonyGiorgio@users.noreply.github.com>
Date: Sat, 10 Jan 2026 11:17:57 -0600
Subject: [PATCH 02/11] ci: enable TestFlight submission for ios-tts PR builds

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
---
 .github/workflows/mobile-build.yml          |  4 +-
 .github/workflows/testflight-on-comment.yml | 74 ++++++++++++++++++++-
 2 files changed, 73 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/mobile-build.yml b/.github/workflows/mobile-build.yml
index 27681a3e..f17178e3 100644
--- a/.github/workflows/mobile-build.yml
+++ b/.github/workflows/mobile-build.yml
@@ -158,11 +158,11 @@ jobs:
           retention-days: 5
 
       - name: Submit to TestFlight
-        # TODO: Remove ios-tts condition after PR #378 is merged
+        # TODO: Remove ios-tts-working condition after PR #385 is merged
         # For this PR, we want to test TestFlight submissions on every build
         if: |
           (github.event_name == 'push' && github.ref == 'refs/heads/master') ||
-          (github.event_name == 'pull_request' && github.head_ref == 'ios-tts')
+          (github.event_name == 'pull_request' && github.head_ref == 'ios-tts-working')
         run: |
           # Find the actual path of the IPA file
           IPA_PATH=$(find frontend/src-tauri/gen/apple/build -name "*.ipa" | head -n 1)
diff --git a/.github/workflows/testflight-on-comment.yml b/.github/workflows/testflight-on-comment.yml
index f72da15a..12f57f0c 100644
--- a/.github/workflows/testflight-on-comment.yml
+++ b/.github/workflows/testflight-on-comment.yml
@@ -3,6 +3,12 @@ name: TestFlight on Comment
 on:
   issue_comment:
     types: [created]
+  # TODO: Remove this push trigger after PR #385 is merged
+  # This is a temporary workaround because issue_comment workflows run from master,
+  # so they don't pick up workflow changes from the PR branch
+  push:
+    branches:
+      - ios-tts-working
 
 permissions:
   contents: read
@@ -11,7 +17,8 @@ permissions:
 
 jobs:
   check-comment:
-    if: github.event.issue.pull_request && contains(github.event.comment.body, 'testflight build')
+    # Only run on issue_comment events, not on push
+    if: github.event_name == 'issue_comment' && github.event.issue.pull_request && contains(github.event.comment.body, 'testflight build')
     runs-on: ubuntu-latest
     outputs:
       should-deploy: ${{ steps.check.outputs.should-deploy }}
@@ -63,12 +70,14 @@ jobs:
 
   deploy-testflight:
     needs: check-comment
-    if: needs.check-comment.outputs.should-deploy == 'true'
+    # Run on push to ios-tts branch OR when triggered by comment with approval
+    if: github.event_name == 'push' || needs.check-comment.outputs.should-deploy == 'true'
     runs-on: macos-latest-xlarge
     steps:
       - uses: actions/checkout@v4
         with:
-          ref: ${{ format('refs/pull/{0}/head', needs.check-comment.outputs.pr-number) }}
+          # For push events, use the current ref; for comment events, use the PR ref
+          ref: ${{ github.event_name == 'push' && github.ref || format('refs/pull/{0}/head', needs.check-comment.outputs.pr-number) }}
 
       - name: Setup Bun
         uses: oven-sh/setup-bun@v1
@@ -111,6 +120,63 @@ jobs:
         working-directory: ./frontend
         run: bun install
 
+      - name: Cache ONNX Runtime iOS build
+        uses: actions/cache@v4
+        id: cache-onnxruntime
+        with:
+          path: |
+            frontend/src-tauri/onnxruntime-ios
+            frontend/src-tauri/onnxruntime-build
+          key: onnxruntime-ios-built-1.22.2-v1
+          restore-keys: |
+            onnxruntime-ios-built-1.22.2-
+
+      - name: Build ONNX Runtime for iOS from source
+        if: steps.cache-onnxruntime.outputs.cache-hit != 'true'
+        working-directory: ./frontend/src-tauri
+        run: |
+          chmod +x scripts/build-ios-onnxruntime.sh
+          ./scripts/build-ios-onnxruntime.sh 1.22.2
+        timeout-minutes: 90
+
+      - name: Verify ONNX Runtime files
+        run: |
+          echo "Checking ONNX Runtime xcframework..."
+          ls -la ${{ github.workspace }}/frontend/src-tauri/onnxruntime-ios/onnxruntime.xcframework/
+          ls -la ${{ github.workspace }}/frontend/src-tauri/onnxruntime-ios/onnxruntime.xcframework/ios-arm64/
+          echo ""
+          echo "Library info:"
+          file ${{ github.workspace }}/frontend/src-tauri/onnxruntime-ios/onnxruntime.xcframework/ios-arm64/libonnxruntime.a
+          echo ""
+          echo "Checking for Abseil symbols (should be included):"
+          nm ${{ github.workspace }}/frontend/src-tauri/onnxruntime-ios/onnxruntime.xcframework/ios-arm64/libonnxruntime.a 2>/dev/null | grep -i "absl" | head -20 || echo "No abseil symbols found (they may be internal)"
+
+      - name: Configure Cargo for iOS ONNX Runtime
+        run: |
+          # Create cargo config with absolute paths for iOS builds
+          # This overrides ort-sys's build script to use our built-from-source library
+          WORKSPACE="${{ github.workspace }}"
+          mkdir -p "${WORKSPACE}/frontend/src-tauri/.cargo"
+          cat > "${WORKSPACE}/frontend/src-tauri/.cargo/config.toml" << EOF
+          # Auto-generated cargo config for iOS ONNX Runtime linking
+          # Uses absolute paths because xcodebuild may run cargo from different directories
+          
+          [target.aarch64-apple-ios.onnxruntime]
+          rustc-link-search = ["${WORKSPACE}/frontend/src-tauri/onnxruntime-ios/onnxruntime.xcframework/ios-arm64"]
+          rustc-link-lib = ["static=onnxruntime"]
+          
+          [target.aarch64-apple-ios-sim.onnxruntime]
+          rustc-link-search = ["${WORKSPACE}/frontend/src-tauri/onnxruntime-ios/onnxruntime.xcframework/ios-arm64-simulator"]
+          rustc-link-lib = ["static=onnxruntime"]
+          
+          [target.x86_64-apple-ios.onnxruntime]
+          rustc-link-search = ["${WORKSPACE}/frontend/src-tauri/onnxruntime-ios/onnxruntime.xcframework/ios-arm64-simulator"]
+          rustc-link-lib = ["static=onnxruntime"]
+          EOF
+          
+          echo "Generated cargo config:"
+          cat "${WORKSPACE}/frontend/src-tauri/.cargo/config.toml"
+
       - name: Setup Xcode
         uses: maxim-lobanov/setup-xcode@v1
         with:
@@ -147,6 +213,8 @@ jobs:
           VITE_OPEN_SECRET_API_URL: https://enclave.trymaple.ai
           VITE_MAPLE_BILLING_API_URL: https://billing.opensecret.cloud
           VITE_CLIENT_ID: ba5a14b5-d915-47b1-b7b1-afda52bc5fc6
+          # ONNX Runtime location for ort-sys crate
+          ORT_LIB_LOCATION: ${{ github.workspace }}/frontend/src-tauri/onnxruntime-ios/onnxruntime.xcframework/ios-arm64
 
       - name: Submit to TestFlight
         run: |

From 21002580f6123c4cac2fc009e456348bd11ab8a9 Mon Sep 17 00:00:00 2001
From: Tony Giorgio <101225832+TonyGiorgio@users.noreply.github.com>
Date: Sat, 10 Jan 2026 11:18:15 -0600
Subject: [PATCH 03/11] feat(ios): add local iOS TTS development tooling and
 documentation

- Add build-ios-onnxruntime-all.sh to build ONNX Runtime for device + simulator
- Add setup-ios-cargo-config.sh to generate .cargo/config.toml with correct paths
- Add justfile commands: ios-build-onnxruntime, ios-setup-cargo-config, ios-fix-arch
- Fix arm64-sim Xcode architecture issue in project.pbxproj
- Configure vite to bind to 0.0.0.0 so iOS simulator can connect
- Add comprehensive docs/ios-tts-local-development.md guide

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
---
 docs/ios-tts-local-development.md             | 166 ++++++++++++++
 .../gen/apple/maple.xcodeproj/project.pbxproj |  45 ++--
 .../scripts/build-ios-onnxruntime-all.sh      | 212 ++++++++++++++++++
 .../scripts/setup-ios-cargo-config.sh         |  63 ++++++
 frontend/vite.config.ts                       |   5 +
 justfile                                      |  20 ++
 6 files changed, 484 insertions(+), 27 deletions(-)
 create mode 100644 docs/ios-tts-local-development.md
 create mode 100755 frontend/src-tauri/scripts/build-ios-onnxruntime-all.sh
 create mode 100755 frontend/src-tauri/scripts/setup-ios-cargo-config.sh

diff --git a/docs/ios-tts-local-development.md b/docs/ios-tts-local-development.md
new file mode 100644
index 00000000..274167a6
--- /dev/null
+++ b/docs/ios-tts-local-development.md
@@ -0,0 +1,166 @@
+# iOS TTS Local Development Guide
+
+This guide explains how to build and test the iOS TTS (Text-to-Speech) feature locally using the iOS Simulator or a physical device.
+
+## Overview
+
+The iOS TTS feature uses ONNX Runtime to run Kokoro TTS models. ONNX Runtime must be built from source for iOS because:
+1. Pre-built binaries from HuggingFace are missing Abseil symbols
+2. We need both device (arm64) and simulator (arm64) builds
+3. The simulator build requires a workaround for a libiconv linking bug
+
+## Prerequisites
+
+- macOS with Xcode installed (16.x+)
+- CMake 3.26+
+- Python 3.8+
+- Git
+- Nix (recommended) or manually install Rust toolchain
+
+## Quick Start
+
+### 1. Build ONNX Runtime
+
+```bash
+just ios-build-onnxruntime
+```
+
+This builds ONNX Runtime for both device and simulator (~5-10 minutes) and automatically generates the cargo config.
+
+The output will be in `frontend/src-tauri/onnxruntime-ios/onnxruntime.xcframework/`.
+
+### 2. Regenerate Cargo Config (if needed)
+
+If you move the project or need to regenerate the cargo config:
+
+```bash
+just ios-setup-cargo-config
+```
+
+This creates `frontend/src-tauri/.cargo/config.toml` with the correct absolute paths for your machine.
+
+### 3. Fix arm64-sim Xcode Issue (if needed)
+
+If you see this error:
+```
+clang: error: version '-sim' in target triple 'arm64-apple-ios13.0-simulator-sim' is invalid
+```
+
+See [troubleshooting-ios-build.md](./troubleshooting-ios-build.md) for details.
+
+Quick fix:
+```bash
+just ios-fix-arch
+```
+
+### 4. Run on Simulator
+
+```bash
+# Boot simulator first
+xcrun simctl boot "iPhone 16 Pro"
+
+# Run the app
+just ios-dev-sim "iPhone 16 Pro"
+```
+
+### 5. Run on Physical Device
+
+```bash
+just ios-dev
+```
+
+Note: If you have a device connected (even wirelessly), `just ios-dev` may deploy to it instead of the simulator. Use `just ios-dev-sim` to explicitly target the simulator.
+
+## Troubleshooting
+
+### Vite Server Not Reachable
+
+The iOS simulator needs to connect to your development server. Ensure `frontend/vite.config.ts` has:
+
+```typescript
+server: {
+  host: "0.0.0.0",
+  port: 5173,
+  strictPort: true
+}
+```
+
+### Missing Abseil Symbols
+
+If you see linker errors like:
+```
+Undefined symbols for architecture arm64:
+  "_AbslInternalSpinLockDelay_lts_20240722"
+```
+
+This means the ONNX Runtime library wasn't built from source. Pre-built binaries are missing these symbols. Run `./scripts/build-ios-onnxruntime-all.sh` to build from source.
+
+### Simulator Build Fails with libiconv Error
+
+If the simulator build fails with:
+```
+ld: building for 'iOS-simulator', but linking in dylib built for 'iOS'
+```
+
+This is fixed by adding `CMAKE_FIND_ROOT_PATH_MODE_LIBRARY=NEVER` to the cmake flags. The `build-ios-onnxruntime-all.sh` script already includes this fix.
+
+### Cargo Not Finding Library
+
+1. Ensure `.cargo/config.toml` uses absolute paths
+2. Clean and rebuild: `cd frontend/src-tauri && cargo clean`
+3. Verify the library exists: `ls -la onnxruntime-ios/onnxruntime.xcframework/ios-arm64-simulator/`
+
+## Architecture Notes
+
+### Why Build from Source?
+
+1. **Abseil symbols**: ONNX Runtime depends on Abseil (Google's C++ library). Pre-built binaries don't include these statically linked.
+
+2. **Simulator support**: Pre-built libraries often only include device builds.
+
+3. **Version compatibility**: Building from source ensures compatibility with our ort-sys Rust crate version.
+
+### Build Artifacts
+
+After building, you'll have:
+```
+frontend/src-tauri/
+├── onnxruntime-build/          # Build directory (can be deleted after build)
+│   └── onnxruntime/            # ONNX Runtime source
+└── onnxruntime-ios/            # Output directory
+    └── onnxruntime.xcframework/
+        ├── Headers/
+        ├── Info.plist
+        ├── ios-arm64/
+        │   └── libonnxruntime.a     # Device library (~69MB)
+        └── ios-arm64-simulator/
+            └── libonnxruntime.a     # Simulator library (~69MB)
+```
+
+### .cargo/config.toml
+
+The cargo config tells the Rust `ort-sys` crate where to find the ONNX Runtime library. The keys are:
+- `[target.aarch64-apple-ios.onnxruntime]` - Device builds
+- `[target.aarch64-apple-ios-sim.onnxruntime]` - Simulator builds (ARM64 Mac)
+- `[target.x86_64-apple-ios.onnxruntime]` - Simulator builds (Intel Mac)
+
+### CI/CD
+
+The CI workflow (`mobile-build.yml`) builds ONNX Runtime from source and caches it. The cache key includes the version number, so updating `ORT_VERSION` will trigger a rebuild.
+
+## Cleaning Up
+
+To free disk space after testing:
+
+```bash
+# Remove build directory (keeps the built xcframework)
+rm -rf frontend/src-tauri/onnxruntime-build
+
+# Remove everything (requires rebuilding)
+rm -rf frontend/src-tauri/onnxruntime-build frontend/src-tauri/onnxruntime-ios
+```
+
+## Related Documentation
+
+- [troubleshooting-ios-build.md](./troubleshooting-ios-build.md) - arm64-sim architecture fix
+- [tts-research.md](./tts-research.md) - TTS implementation details
diff --git a/frontend/src-tauri/gen/apple/maple.xcodeproj/project.pbxproj b/frontend/src-tauri/gen/apple/maple.xcodeproj/project.pbxproj
index 435919c9..b26d4c6e 100644
--- a/frontend/src-tauri/gen/apple/maple.xcodeproj/project.pbxproj
+++ b/frontend/src-tauri/gen/apple/maple.xcodeproj/project.pbxproj
@@ -251,18 +251,15 @@
 			isa = XCBuildConfiguration;
 			buildSettings = {
 				ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES = YES;
-				ARCHS = (
-					arm64,
-					"arm64-sim",
-				);
+				ARCHS = arm64;
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				CODE_SIGN_ENTITLEMENTS = maple_iOS/maple_iOS.entitlements;
 				CODE_SIGN_IDENTITY = "Apple Development";
 				CODE_SIGN_STYLE = Automatic;
-				DEVELOPMENT_TEAM = X773Y823TN;
+				DEVELOPMENT_TEAM = "X773Y823TN";
 				ENABLE_BITCODE = NO;
-				"EXCLUDED_ARCHS[sdk=iphoneos*]" = "arm64-sim x86_64";
-				"EXCLUDED_ARCHS[sdk=iphonesimulator*]" = arm64;
+				"EXCLUDED_ARCHS[sdk=iphoneos*]" = x86_64;
+				"EXCLUDED_ARCHS[sdk=iphonesimulator*]" = "";
 				FRAMEWORK_SEARCH_PATHS = (
 					"$(inherited)",
 					"\".\"",
@@ -294,11 +291,11 @@
 					"$(TOOLCHAIN_DIR)/usr/lib/swift-5.0/$(PLATFORM_NAME)",
 				);
 				PRODUCT_BUNDLE_IDENTIFIER = cloud.opensecret.maple;
-				PRODUCT_NAME = Maple;
+				PRODUCT_NAME = "Maple";
 				PROVISIONING_PROFILE_SPECIFIER = "";
 				SDKROOT = iphoneos;
 				TARGETED_DEVICE_FAMILY = "1,2";
-				VALID_ARCHS = "arm64  arm64-sim";
+				VALID_ARCHS = arm64;
 			};
 			name = debug;
 		};
@@ -425,18 +422,15 @@
 			isa = XCBuildConfiguration;
 			buildSettings = {
 				ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES = YES;
-				ARCHS = (
-					arm64,
-					"arm64-sim",
-				);
+				ARCHS = arm64;
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				CODE_SIGN_ENTITLEMENTS = maple_iOS/maple_iOS.entitlements;
 				CODE_SIGN_IDENTITY = "Apple Development";
 				CODE_SIGN_STYLE = Automatic;
-				DEVELOPMENT_TEAM = X773Y823TN;
+				DEVELOPMENT_TEAM = "X773Y823TN";
 				ENABLE_BITCODE = NO;
-				"EXCLUDED_ARCHS[sdk=iphoneos*]" = "arm64-sim x86_64";
-				"EXCLUDED_ARCHS[sdk=iphonesimulator*]" = arm64;
+				"EXCLUDED_ARCHS[sdk=iphoneos*]" = x86_64;
+				"EXCLUDED_ARCHS[sdk=iphonesimulator*]" = "";
 				FRAMEWORK_SEARCH_PATHS = (
 					"$(inherited)",
 					"\".\"",
@@ -468,11 +462,11 @@
 					"$(TOOLCHAIN_DIR)/usr/lib/swift-5.0/$(PLATFORM_NAME)",
 				);
 				PRODUCT_BUNDLE_IDENTIFIER = cloud.opensecret.maple;
-				PRODUCT_NAME = Maple;
+				PRODUCT_NAME = "Maple";
 				PROVISIONING_PROFILE_SPECIFIER = "";
 				SDKROOT = iphoneos;
 				TARGETED_DEVICE_FAMILY = "1,2";
-				VALID_ARCHS = "arm64  arm64-sim";
+				VALID_ARCHS = arm64;
 			};
 			name = release;
 		};
@@ -543,20 +537,17 @@
 			isa = XCBuildConfiguration;
 			buildSettings = {
 				ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES = YES;
-				ARCHS = (
-					arm64,
-					"arm64-sim",
-				);
+				ARCHS = arm64;
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				CODE_SIGN_ENTITLEMENTS = maple_iOS/maple_iOS.entitlements;
 				CODE_SIGN_IDENTITY = "Apple Development";
 				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
 				CODE_SIGN_STYLE = Manual;
-				DEVELOPMENT_TEAM = X773Y823TN;
+				DEVELOPMENT_TEAM = "X773Y823TN";
 				"DEVELOPMENT_TEAM[sdk=iphoneos*]" = X773Y823TN;
 				ENABLE_BITCODE = NO;
-				"EXCLUDED_ARCHS[sdk=iphoneos*]" = "arm64-sim x86_64";
-				"EXCLUDED_ARCHS[sdk=iphonesimulator*]" = arm64;
+				"EXCLUDED_ARCHS[sdk=iphoneos*]" = x86_64;
+				"EXCLUDED_ARCHS[sdk=iphonesimulator*]" = "";
 				FRAMEWORK_SEARCH_PATHS = (
 					"$(inherited)",
 					"\".\"",
@@ -588,12 +579,12 @@
 					"$(TOOLCHAIN_DIR)/usr/lib/swift-5.0/$(PLATFORM_NAME)",
 				);
 				PRODUCT_BUNDLE_IDENTIFIER = cloud.opensecret.maple;
-				PRODUCT_NAME = Maple;
+				PRODUCT_NAME = "Maple";
 				PROVISIONING_PROFILE_SPECIFIER = "86059ea7-ae8e-44af-8a58-b2ab7c78d299";
 				"PROVISIONING_PROFILE_SPECIFIER[sdk=iphoneos*]" = "86059ea7-ae8e-44af-8a58-b2ab7c78d299";
 				SDKROOT = iphoneos;
 				TARGETED_DEVICE_FAMILY = "1,2";
-				VALID_ARCHS = "arm64  arm64-sim";
+				VALID_ARCHS = arm64;
 			};
 			name = local;
 		};
diff --git a/frontend/src-tauri/scripts/build-ios-onnxruntime-all.sh b/frontend/src-tauri/scripts/build-ios-onnxruntime-all.sh
new file mode 100755
index 00000000..390c2aa8
--- /dev/null
+++ b/frontend/src-tauri/scripts/build-ios-onnxruntime-all.sh
@@ -0,0 +1,212 @@
+#!/bin/bash
+# Build ONNX Runtime from source for iOS (device + simulator)
+# This creates a static library with all dependencies (including Abseil) statically linked
+#
+# Prerequisites:
+# - macOS with Xcode installed
+# - CMake 3.26+
+# - Python 3.8+
+# - Git
+#
+# Usage: ./build-ios-onnxruntime-all.sh [version]
+# Example: ./build-ios-onnxruntime-all.sh 1.22.2
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+TAURI_DIR="$(dirname "$SCRIPT_DIR")"
+ORT_VERSION="${1:-1.22.2}"
+BUILD_DIR="${TAURI_DIR}/onnxruntime-build"
+OUTPUT_DIR="${TAURI_DIR}/onnxruntime-ios"
+XCFRAMEWORK_DIR="${OUTPUT_DIR}/onnxruntime.xcframework"
+
+IOS_DEPLOYMENT_TARGET="13.0"
+
+echo "========================================"
+echo "Building ONNX Runtime ${ORT_VERSION} for iOS"
+echo "(Device + Simulator)"
+echo "========================================"
+echo "Build directory: ${BUILD_DIR}"
+echo "Output directory: ${OUTPUT_DIR}"
+echo ""
+
+# Check prerequisites
+command -v cmake >/dev/null 2>&1 || { echo "Error: cmake is required"; exit 1; }
+command -v python3 >/dev/null 2>&1 || { echo "Error: python3 is required"; exit 1; }
+command -v git >/dev/null 2>&1 || { echo "Error: git is required"; exit 1; }
+command -v xcodebuild >/dev/null 2>&1 || { echo "Error: Xcode is required"; exit 1; }
+
+# Check if output already exists
+if [ -d "$XCFRAMEWORK_DIR" ] && [ -f "${XCFRAMEWORK_DIR}/ios-arm64/libonnxruntime.a" ] && [ -f "${XCFRAMEWORK_DIR}/ios-arm64-simulator/libonnxruntime.a" ]; then
+    echo "ONNX Runtime xcframework already exists with both device and simulator libraries"
+    echo "To rebuild, remove: rm -rf $OUTPUT_DIR"
+    exit 0
+fi
+
+mkdir -p "$BUILD_DIR"
+cd "$BUILD_DIR"
+
+# Clone ONNX Runtime
+clone_with_retry() {
+    local max_attempts=3
+    local attempt=1
+    while [ $attempt -le $max_attempts ]; do
+        echo "Attempt $attempt of $max_attempts..."
+        if git clone --depth 1 --branch "v${ORT_VERSION}" --recursive https://github.com/microsoft/onnxruntime.git; then
+            return 0
+        fi
+        sleep 10
+        attempt=$((attempt + 1))
+    done
+    return 1
+}
+
+if [ ! -d "onnxruntime" ]; then
+    echo "Cloning ONNX Runtime repository..."
+    clone_with_retry
+fi
+
+cd onnxruntime
+
+# Common cmake defines
+CMAKE_EXTRA_DEFINES="CMAKE_POLICY_VERSION_MINIMUM=3.5"
+
+# Function to build and combine libraries
+build_and_combine() {
+    local SYSROOT=$1
+    local OUTPUT_SUFFIX=$2
+    local EXTRA_CMAKE_DEFINES=$3
+    
+    echo ""
+    echo "========================================"
+    echo "Building for ${SYSROOT} (arm64)..."
+    echo "========================================"
+    
+    # Clean previous build for this target
+    rm -rf "build/iOS/Release"
+    
+    ./build.sh \
+        --build_dir build/iOS \
+        --config Release \
+        --use_xcode \
+        --ios \
+        --apple_sysroot "${SYSROOT}" \
+        --osx_arch arm64 \
+        --apple_deploy_target "${IOS_DEPLOYMENT_TARGET}" \
+        --parallel \
+        --skip_tests \
+        --compile_no_warning_as_error \
+        --cmake_extra_defines "${CMAKE_EXTRA_DEFINES} ${EXTRA_CMAKE_DEFINES}"
+    
+    # Find and combine libraries
+    local BUILD_OUTPUT_DIR="build/iOS/Release/Release-${SYSROOT}"
+    local COMBINED_LIB="${BUILD_OUTPUT_DIR}/libonnxruntime_combined.a"
+    
+    echo "Combining static libraries..."
+    local LIBS=$(find build/iOS/Release -name "*.a" -path "*Release-${SYSROOT}*" -type f | grep -v "gtest\|gmock" | sort -u)
+    
+    if [ -z "$LIBS" ]; then
+        echo "Error: No libraries found for ${SYSROOT}"
+        return 1
+    fi
+    
+    libtool -static -o "$COMBINED_LIB" $LIBS 2>&1 | grep -v "warning duplicate member" || true
+    
+    if [ ! -f "$COMBINED_LIB" ]; then
+        echo "Error: Failed to create combined library"
+        return 1
+    fi
+    
+    echo "Created: $COMBINED_LIB ($(du -h "$COMBINED_LIB" | cut -f1))"
+    
+    # Copy to output
+    mkdir -p "${XCFRAMEWORK_DIR}/${OUTPUT_SUFFIX}"
+    cp "$COMBINED_LIB" "${XCFRAMEWORK_DIR}/${OUTPUT_SUFFIX}/libonnxruntime.a"
+}
+
+# Create output directories
+mkdir -p "${OUTPUT_DIR}"
+mkdir -p "${XCFRAMEWORK_DIR}/Headers"
+
+# Build for device
+build_and_combine "iphoneos" "ios-arm64" ""
+
+# Build for simulator
+# CMAKE_FIND_ROOT_PATH_MODE_LIBRARY=NEVER fixes the libiconv linking bug
+build_and_combine "iphonesimulator" "ios-arm64-simulator" "CMAKE_FIND_ROOT_PATH_MODE_LIBRARY=NEVER"
+
+# Copy headers
+HEADER_DIR=$(find build -name "onnxruntime_c_api.h" -type f | head -n 1 | xargs dirname 2>/dev/null)
+if [ -n "$HEADER_DIR" ]; then
+    cp "${HEADER_DIR}"/*.h "${XCFRAMEWORK_DIR}/Headers/" 2>/dev/null || true
+fi
+if [ -d "include/onnxruntime/core/session" ]; then
+    cp include/onnxruntime/core/session/*.h "${XCFRAMEWORK_DIR}/Headers/" 2>/dev/null || true
+fi
+
+# Create Info.plist
+cat > "${XCFRAMEWORK_DIR}/Info.plist" << 'PLIST'
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>AvailableLibraries</key>
+    <array>
+        <dict>
+            <key>HeadersPath</key>
+            <string>Headers</string>
+            <key>LibraryIdentifier</key>
+            <string>ios-arm64</string>
+            <key>LibraryPath</key>
+            <string>libonnxruntime.a</string>
+            <key>SupportedArchitectures</key>
+            <array>
+                <string>arm64</string>
+            </array>
+            <key>SupportedPlatform</key>
+            <string>ios</string>
+        </dict>
+        <dict>
+            <key>HeadersPath</key>
+            <string>Headers</string>
+            <key>LibraryIdentifier</key>
+            <string>ios-arm64-simulator</string>
+            <key>LibraryPath</key>
+            <string>libonnxruntime.a</string>
+            <key>SupportedArchitectures</key>
+            <array>
+                <string>arm64</string>
+            </array>
+            <key>SupportedPlatform</key>
+            <string>ios</string>
+            <key>SupportedPlatformVariant</key>
+            <string>simulator</string>
+        </dict>
+    </array>
+    <key>CFBundlePackageType</key>
+    <string>XFWK</string>
+    <key>XCFrameworkFormatVersion</key>
+    <string>1.0</string>
+</dict>
+</plist>
+PLIST
+
+echo ""
+echo "========================================"
+echo "Build complete!"
+echo "========================================"
+echo ""
+echo "xcframework: ${XCFRAMEWORK_DIR}"
+echo ""
+echo "Libraries:"
+ls -lh "${XCFRAMEWORK_DIR}/ios-arm64/libonnxruntime.a"
+ls -lh "${XCFRAMEWORK_DIR}/ios-arm64-simulator/libonnxruntime.a"
+# Generate cargo config
+echo ""
+echo "Generating .cargo/config.toml..."
+"${SCRIPT_DIR}/setup-ios-cargo-config.sh"
+
+echo ""
+echo "Next steps:"
+echo "1. Fix arm64-sim issue if needed (see docs/troubleshooting-ios-build.md)"
+echo "2. Run: just ios-dev-sim 'iPhone 16 Pro'"
diff --git a/frontend/src-tauri/scripts/setup-ios-cargo-config.sh b/frontend/src-tauri/scripts/setup-ios-cargo-config.sh
new file mode 100755
index 00000000..7f5e09fe
--- /dev/null
+++ b/frontend/src-tauri/scripts/setup-ios-cargo-config.sh
@@ -0,0 +1,63 @@
+#!/bin/bash
+# Generate .cargo/config.toml for iOS ONNX Runtime linking
+# This script creates the config with absolute paths based on the current directory
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+TAURI_DIR="$(dirname "$SCRIPT_DIR")"
+CARGO_DIR="${TAURI_DIR}/.cargo"
+CONFIG_FILE="${CARGO_DIR}/config.toml"
+XCFRAMEWORK_DIR="${TAURI_DIR}/onnxruntime-ios/onnxruntime.xcframework"
+
+# Check if xcframework exists
+if [ ! -d "$XCFRAMEWORK_DIR" ]; then
+    echo "Error: ONNX Runtime xcframework not found at: $XCFRAMEWORK_DIR"
+    echo "Run ./scripts/build-ios-onnxruntime-all.sh first"
+    exit 1
+fi
+
+# Check for required libraries
+if [ ! -f "${XCFRAMEWORK_DIR}/ios-arm64/libonnxruntime.a" ]; then
+    echo "Error: Device library not found. Build ONNX Runtime first."
+    exit 1
+fi
+
+mkdir -p "$CARGO_DIR"
+
+echo "Generating ${CONFIG_FILE}..."
+
+cat > "$CONFIG_FILE" << EOF
+# Auto-generated cargo config for iOS ONNX Runtime linking
+# Generated by: scripts/setup-ios-cargo-config.sh
+# Regenerate with: ./scripts/setup-ios-cargo-config.sh
+
+[target.aarch64-apple-ios.onnxruntime]
+rustc-link-search = ["${XCFRAMEWORK_DIR}/ios-arm64"]
+rustc-link-lib = ["static=onnxruntime"]
+
+[target.aarch64-apple-ios-sim.onnxruntime]
+rustc-link-search = ["${XCFRAMEWORK_DIR}/ios-arm64-simulator"]
+rustc-link-lib = ["static=onnxruntime"]
+
+[target.x86_64-apple-ios.onnxruntime]
+rustc-link-search = ["${XCFRAMEWORK_DIR}/ios-arm64-simulator"]
+rustc-link-lib = ["static=onnxruntime"]
+
+[env]
+ORT_LIB_LOCATION = "${XCFRAMEWORK_DIR}/ios-arm64"
+EOF
+
+echo "Created: $CONFIG_FILE"
+echo ""
+echo "Paths configured:"
+echo "  Device:    ${XCFRAMEWORK_DIR}/ios-arm64"
+echo "  Simulator: ${XCFRAMEWORK_DIR}/ios-arm64-simulator"
+
+# Verify simulator library exists (warn if not)
+if [ ! -f "${XCFRAMEWORK_DIR}/ios-arm64-simulator/libonnxruntime.a" ]; then
+    echo ""
+    echo "Warning: Simulator library not found!"
+    echo "Device builds will work, but simulator builds will fail."
+    echo "Run ./scripts/build-ios-onnxruntime-all.sh to build both."
+fi
diff --git a/frontend/vite.config.ts b/frontend/vite.config.ts
index 17a924c3..01057f42 100644
--- a/frontend/vite.config.ts
+++ b/frontend/vite.config.ts
@@ -11,5 +11,10 @@ export default defineConfig({
     alias: {
       "@": path.resolve(__dirname, "./src")
     }
+  },
+  server: {
+    host: "0.0.0.0",
+    port: 5173,
+    strictPort: true
   }
 });
diff --git a/justfile b/justfile
index 07022d9a..de9e4810 100644
--- a/justfile
+++ b/justfile
@@ -35,6 +35,26 @@ ios-dev-sim simulator:
 ios-dev-device device:
     cd frontend && bun run tauri ios dev --device '{{device}}'
 
+# Build ONNX Runtime for iOS (device + simulator) - required for TTS
+ios-build-onnxruntime:
+    cd frontend/src-tauri && ./scripts/build-ios-onnxruntime-all.sh
+
+# Setup cargo config for iOS ONNX Runtime (run after building ONNX Runtime)
+ios-setup-cargo-config:
+    cd frontend/src-tauri && ./scripts/setup-ios-cargo-config.sh
+
+# Fix arm64-sim Xcode architecture issue (run if you get arm64-sim errors)
+ios-fix-arch:
+    #!/usr/bin/env bash
+    set -euo pipefail
+    cd frontend/src-tauri/gen/apple
+    echo "Fixing arm64-sim architecture issue..."
+    perl -i -0pe 's/ARCHS = \(\s*arm64,\s*"arm64-sim",\s*\);/ARCHS = arm64;/g' maple.xcodeproj/project.pbxproj
+    sed -i '' 's/VALID_ARCHS = "arm64  arm64-sim";/VALID_ARCHS = arm64;/g' maple.xcodeproj/project.pbxproj
+    sed -i '' 's/"EXCLUDED_ARCHS\[sdk=iphoneos\*\]" = "arm64-sim x86_64";/"EXCLUDED_ARCHS[sdk=iphoneos*]" = x86_64;/g' maple.xcodeproj/project.pbxproj
+    sed -i '' 's/"EXCLUDED_ARCHS\[sdk=iphonesimulator\*\]" = arm64;/"EXCLUDED_ARCHS[sdk=iphonesimulator*]" = "";/g' maple.xcodeproj/project.pbxproj
+    echo "Fixed! Verify with: grep -E 'ARCHS =|VALID_ARCHS|EXCLUDED_ARCHS' maple.xcodeproj/project.pbxproj"
+
 # Build Tauri Android release
 android-build:
     cd frontend && bun run tauri android build

From fae1862ff7a7e7b094b994df947e16204aacde7d Mon Sep 17 00:00:00 2001
From: Tony Giorgio <101225832+TonyGiorgio@users.noreply.github.com>
Date: Sat, 10 Jan 2026 11:18:31 -0600
Subject: [PATCH 04/11] fix(ios): handle AudioContext unavailability and show
 error for Lockdown Mode

- Add webkitAudioContext fallback for iOS Safari compatibility
- Handle suspended audio context state (iOS requires user interaction)
- Show user-friendly error when AudioContext is unavailable (Lockdown Mode)
- Add playbackError state and clearPlaybackError to TTS context
- Display dismissible error alert in UnifiedChat when TTS playback fails

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
---
 frontend/src/components/UnifiedChat.tsx  | 21 ++++++++++++++
 frontend/src/services/tts/TTSContext.tsx | 36 ++++++++++++++++++++----
 2 files changed, 51 insertions(+), 6 deletions(-)

diff --git a/frontend/src/components/UnifiedChat.tsx b/frontend/src/components/UnifiedChat.tsx
index d1ce813d..1bd0ecc4 100644
--- a/frontend/src/components/UnifiedChat.tsx
+++ b/frontend/src/components/UnifiedChat.tsx
@@ -874,6 +874,7 @@ export function UnifiedChat() {
   const os = useOpenSecret();
   const isTauriEnv = isTauri();
   const queryClient = useQueryClient();
+  const { playbackError, clearPlaybackError } = useTTS();
 
   // Track chatId from URL - use state so we can update it
   const [chatId, setChatId] = useState<string | undefined>(() => {
@@ -2663,6 +2664,26 @@ export function UnifiedChat() {
           </div>
         )}
 
+        {/* TTS playback error - shows when audio context is unavailable (e.g., Lockdown Mode) */}
+        {playbackError && (
+          <div className="fixed top-16 left-1/2 -translate-x-1/2 z-50 w-full max-w-2xl px-4 md:left-[calc(50%+140px)]">
+            <Alert variant="destructive" className="bg-background">
+              <AlertCircle className="h-4 w-4" />
+              <AlertDescription className="flex items-center justify-between">
+                <span>{playbackError}</span>
+                <Button
+                  variant="ghost"
+                  size="sm"
+                  className="h-6 px-2 ml-2"
+                  onClick={clearPlaybackError}
+                >
+                  <X className="h-4 w-4" />
+                </Button>
+              </AlertDescription>
+            </Alert>
+          </div>
+        )}
+
         {/* Sidebar toggle - visible when sidebar is closed */}
         {!isSidebarOpen && (
           <div className="fixed top-[9.5px] left-4 z-20">
diff --git a/frontend/src/services/tts/TTSContext.tsx b/frontend/src/services/tts/TTSContext.tsx
index 5771216b..7fdbfe76 100644
--- a/frontend/src/services/tts/TTSContext.tsx
+++ b/frontend/src/services/tts/TTSContext.tsx
@@ -7,7 +7,7 @@ import {
   useEffect,
   ReactNode
 } from "react";
-import { isTauriDesktop } from "@/utils/platform";
+import { isTauriDesktop, isIOS, isTauri } from "@/utils/platform";
 import { invoke } from "@tauri-apps/api/core";
 import { listen } from "@tauri-apps/api/event";
 
@@ -43,6 +43,7 @@ interface DownloadProgress {
 interface TTSContextValue {
   status: TTSStatus;
   error: string | null;
+  playbackError: string | null;
   downloadProgress: number;
   downloadDetail: string;
   totalSizeMB: number;
@@ -55,13 +56,14 @@ interface TTSContextValue {
   deleteModels: () => Promise<void>;
   speak: (text: string, messageId: string) => Promise<void>;
   stop: () => void;
+  clearPlaybackError: () => void;
 }
 
 const TTSContext = createContext<TTSContextValue | null>(null);
 
 export function TTSProvider({ children }: { children: ReactNode }) {
-  // Check Tauri desktop environment once at mount - TTS is desktop-only
-  const isTauriEnv = isTauriDesktop();
+  // Check Tauri environment - TTS is available on desktop and iOS (not Android)
+  const isTauriEnv = isTauriDesktop() || (isTauri() && isIOS());
 
   // Initial status depends on whether we're in Tauri
   const [status, setStatus] = useState<TTSStatus>(isTauriEnv ? "checking" : "not_available");
@@ -71,6 +73,7 @@ export function TTSProvider({ children }: { children: ReactNode }) {
   const [totalSizeMB, setTotalSizeMB] = useState(264);
   const [isPlaying, setIsPlaying] = useState(false);
   const [currentPlayingId, setCurrentPlayingId] = useState<string | null>(null);
+  const [playbackError, setPlaybackError] = useState<string | null>(null);
 
   const audioContextRef = useRef<AudioContext | null>(null);
   const sourceNodeRef = useRef<AudioBufferSourceNode | null>(null);
@@ -232,7 +235,21 @@ export function TTSProvider({ children }: { children: ReactNode }) {
         audioUrlRef.current = audioUrl;
 
         // Use Web Audio API instead of HTMLAudioElement to avoid hijacking media controls
-        const audioContext = new AudioContext();
+        // iOS Safari requires webkitAudioContext fallback
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const AudioContextClass = window.AudioContext || (window as any).webkitAudioContext;
+        if (!AudioContextClass) {
+          throw new Error(
+            "Audio playback is not available. If you have Lockdown Mode enabled, TTS will not work."
+          );
+        }
+        const audioContext = new AudioContextClass() as AudioContext;
+
+        // iOS requires user interaction to start audio - resume if suspended
+        if (audioContext.state === "suspended") {
+          await audioContext.resume();
+        }
+
         const arrayBuffer = await audioBlob.arrayBuffer();
         const audioBuffer = await audioContext.decodeAudioData(arrayBuffer);
 
@@ -264,13 +281,18 @@ export function TTSProvider({ children }: { children: ReactNode }) {
 
         source.start(0);
       } catch (err) {
-        console.error("TTS synthesis failed:", err);
+        console.error("TTS playback failed:", err);
+        setPlaybackError(err instanceof Error ? err.message : "TTS playback failed");
         stop();
       }
     },
     [isTauriEnv, status, stop]
   );
 
+  const clearPlaybackError = useCallback(() => {
+    setPlaybackError(null);
+  }, []);
+
   // Clean up on unmount
   useEffect(() => {
     return () => {
@@ -301,6 +323,7 @@ export function TTSProvider({ children }: { children: ReactNode }) {
       value={{
         status,
         error,
+        playbackError,
         downloadProgress,
         downloadDetail,
         totalSizeMB,
@@ -311,7 +334,8 @@ export function TTSProvider({ children }: { children: ReactNode }) {
         startDownload,
         deleteModels,
         speak,
-        stop
+        stop,
+        clearPlaybackError
       }}
     >
       {children}

From 0970fd7138a2f930c5f15f98028ca9212757dd6b Mon Sep 17 00:00:00 2001
From: Tony Giorgio <tonygiorgio@protonmail.com>
Date: Wed, 14 Jan 2026 11:46:30 -0600
Subject: [PATCH 05/11] fix(ios): set audioSession type for TTS playback
 routing

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
---
 frontend/src/services/tts/TTSContext.tsx | 41 ++++++++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/frontend/src/services/tts/TTSContext.tsx b/frontend/src/services/tts/TTSContext.tsx
index 7fdbfe76..6936ea2b 100644
--- a/frontend/src/services/tts/TTSContext.tsx
+++ b/frontend/src/services/tts/TTSContext.tsx
@@ -78,6 +78,7 @@ export function TTSProvider({ children }: { children: ReactNode }) {
   const audioContextRef = useRef<AudioContext | null>(null);
   const sourceNodeRef = useRef<AudioBufferSourceNode | null>(null);
   const audioUrlRef = useRef<string | null>(null);
+  const audioSessionPrevTypeRef = useRef<string | null>(null);
   const unlistenRef = useRef<(() => void) | null>(null);
 
   const cleanupDownloadListener = useCallback(() => {
@@ -185,6 +186,19 @@ export function TTSProvider({ children }: { children: ReactNode }) {
       });
       audioContextRef.current = null;
     }
+
+    if (audioSessionPrevTypeRef.current) {
+      try {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const nav = navigator as any;
+        if (nav.audioSession && typeof nav.audioSession.type === "string") {
+          nav.audioSession.type = audioSessionPrevTypeRef.current;
+        }
+      } catch {
+        // Ignore
+      }
+      audioSessionPrevTypeRef.current = null;
+    }
     setIsPlaying(false);
     setCurrentPlayingId(null);
   }, []);
@@ -243,6 +257,20 @@ export function TTSProvider({ children }: { children: ReactNode }) {
             "Audio playback is not available. If you have Lockdown Mode enabled, TTS will not work."
           );
         }
+
+        // iOS: try to force media playback routing (speaker) for Web Audio.
+        // This helps avoid “only works with headphones / earpiece” routing issues.
+        try {
+          // eslint-disable-next-line @typescript-eslint/no-explicit-any
+          const nav = navigator as any;
+          if (nav.audioSession && typeof nav.audioSession.type === "string") {
+            audioSessionPrevTypeRef.current = nav.audioSession.type;
+            nav.audioSession.type = "playback";
+          }
+        } catch {
+          // Ignore
+        }
+
         const audioContext = new AudioContextClass() as AudioContext;
 
         // iOS requires user interaction to start audio - resume if suspended
@@ -277,6 +305,19 @@ export function TTSProvider({ children }: { children: ReactNode }) {
           });
           audioContextRef.current = null;
           sourceNodeRef.current = null;
+
+          if (audioSessionPrevTypeRef.current) {
+            try {
+              // eslint-disable-next-line @typescript-eslint/no-explicit-any
+              const nav = navigator as any;
+              if (nav.audioSession && typeof nav.audioSession.type === "string") {
+                nav.audioSession.type = audioSessionPrevTypeRef.current;
+              }
+            } catch {
+              // Ignore
+            }
+            audioSessionPrevTypeRef.current = null;
+          }
         };
 
         source.start(0);

From 6e3ed8e0881d7e2b9420f57ee763a491c4010e35 Mon Sep 17 00:00:00 2001
From: Tony Giorgio <tonygiorgio@protonmail.com>
Date: Wed, 14 Jan 2026 16:57:46 -0600
Subject: [PATCH 06/11] fix(ios): set Media Session metadata for TTS

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
---
 frontend/src/services/tts/TTSContext.tsx | 83 ++++++++++++++++++++++++
 1 file changed, 83 insertions(+)

diff --git a/frontend/src/services/tts/TTSContext.tsx b/frontend/src/services/tts/TTSContext.tsx
index 6936ea2b..2a5089d5 100644
--- a/frontend/src/services/tts/TTSContext.tsx
+++ b/frontend/src/services/tts/TTSContext.tsx
@@ -79,6 +79,10 @@ export function TTSProvider({ children }: { children: ReactNode }) {
   const sourceNodeRef = useRef<AudioBufferSourceNode | null>(null);
   const audioUrlRef = useRef<string | null>(null);
   const audioSessionPrevTypeRef = useRef<string | null>(null);
+  const mediaSessionPrevStateRef = useRef<{
+    metadata: MediaMetadata | null;
+    playbackState: MediaSessionPlaybackState;
+  } | null>(null);
   const unlistenRef = useRef<(() => void) | null>(null);
 
   const cleanupDownloadListener = useCallback(() => {
@@ -199,6 +203,18 @@ export function TTSProvider({ children }: { children: ReactNode }) {
       }
       audioSessionPrevTypeRef.current = null;
     }
+
+    if (mediaSessionPrevStateRef.current) {
+      try {
+        if ("mediaSession" in navigator) {
+          navigator.mediaSession.metadata = mediaSessionPrevStateRef.current.metadata;
+          navigator.mediaSession.playbackState = mediaSessionPrevStateRef.current.playbackState;
+        }
+      } catch {
+        // Ignore
+      }
+      mediaSessionPrevStateRef.current = null;
+    }
     setIsPlaying(false);
     setCurrentPlayingId(null);
   }, []);
@@ -248,6 +264,35 @@ export function TTSProvider({ children }: { children: ReactNode }) {
         const audioUrl = URL.createObjectURL(audioBlob);
         audioUrlRef.current = audioUrl;
 
+        // iOS: set Now Playing metadata so the audio UI shows Maple instead of the origin hostname.
+        // This is iOS-only and should not affect desktop media controls.
+        try {
+          if (isIOS() && "mediaSession" in navigator && typeof MediaMetadata !== "undefined") {
+            if (!mediaSessionPrevStateRef.current) {
+              mediaSessionPrevStateRef.current = {
+                metadata: navigator.mediaSession.metadata,
+                playbackState: navigator.mediaSession.playbackState
+              };
+            }
+
+            navigator.mediaSession.metadata = new MediaMetadata({
+              title: "Maple AI",
+              artist: "Text to Speech",
+              artwork: [
+                {
+                  src: "/apple-touch-icon.png",
+                  sizes: "180x180",
+                  type: "image/png"
+                },
+                { src: "/favicon.png", sizes: "32x32", type: "image/png" }
+              ]
+            });
+            navigator.mediaSession.playbackState = "playing";
+          }
+        } catch {
+          // Ignore
+        }
+
         // Use Web Audio API instead of HTMLAudioElement to avoid hijacking media controls
         // iOS Safari requires webkitAudioContext fallback
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -318,6 +363,19 @@ export function TTSProvider({ children }: { children: ReactNode }) {
             }
             audioSessionPrevTypeRef.current = null;
           }
+
+          if (mediaSessionPrevStateRef.current) {
+            try {
+              if ("mediaSession" in navigator) {
+                navigator.mediaSession.metadata = mediaSessionPrevStateRef.current.metadata;
+                navigator.mediaSession.playbackState =
+                  mediaSessionPrevStateRef.current.playbackState;
+              }
+            } catch {
+              // Ignore
+            }
+            mediaSessionPrevStateRef.current = null;
+          }
         };
 
         source.start(0);
@@ -356,6 +414,31 @@ export function TTSProvider({ children }: { children: ReactNode }) {
         URL.revokeObjectURL(audioUrlRef.current);
         audioUrlRef.current = null;
       }
+
+      if (audioSessionPrevTypeRef.current) {
+        try {
+          // eslint-disable-next-line @typescript-eslint/no-explicit-any
+          const nav = navigator as any;
+          if (nav.audioSession && typeof nav.audioSession.type === "string") {
+            nav.audioSession.type = audioSessionPrevTypeRef.current;
+          }
+        } catch {
+          // Ignore
+        }
+        audioSessionPrevTypeRef.current = null;
+      }
+
+      if (mediaSessionPrevStateRef.current) {
+        try {
+          if ("mediaSession" in navigator) {
+            navigator.mediaSession.metadata = mediaSessionPrevStateRef.current.metadata;
+            navigator.mediaSession.playbackState = mediaSessionPrevStateRef.current.playbackState;
+          }
+        } catch {
+          // Ignore
+        }
+        mediaSessionPrevStateRef.current = null;
+      }
     };
   }, []);
 

From 12f3bc9e6f850aa700893f3ff599317b37505407 Mon Sep 17 00:00:00 2001
From: Tony Giorgio <tonygiorgio@protonmail.com>
Date: Thu, 15 Jan 2026 15:13:18 -0600
Subject: [PATCH 07/11] fix(ios): clean up build config and harden TestFlight
 workflow

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
---
 .github/workflows/mobile-build.yml            |  4 ---
 .github/workflows/testflight-on-comment.yml   | 10 ++-----
 frontend/src-tauri/build.rs                   | 30 -------------------
 .../scripts/setup-ios-cargo-config.sh         |  4 ---
 .../scripts/setup-ios-onnxruntime.sh          |  2 +-
 frontend/src-tauri/src/tts.rs                 |  2 +-
 frontend/src/components/UnifiedChat.tsx       |  1 +
 frontend/vite.config.ts                       |  1 +
 8 files changed, 7 insertions(+), 47 deletions(-)

diff --git a/.github/workflows/mobile-build.yml b/.github/workflows/mobile-build.yml
index f17178e3..564c3113 100644
--- a/.github/workflows/mobile-build.yml
+++ b/.github/workflows/mobile-build.yml
@@ -101,10 +101,6 @@ jobs:
           [target.aarch64-apple-ios-sim.onnxruntime]
           rustc-link-search = ["${WORKSPACE}/frontend/src-tauri/onnxruntime-ios/onnxruntime.xcframework/ios-arm64-simulator"]
           rustc-link-lib = ["static=onnxruntime"]
-          
-          [target.x86_64-apple-ios.onnxruntime]
-          rustc-link-search = ["${WORKSPACE}/frontend/src-tauri/onnxruntime-ios/onnxruntime.xcframework/ios-arm64-simulator"]
-          rustc-link-lib = ["static=onnxruntime"]
           EOF
           
           echo "Generated cargo config:"
diff --git a/.github/workflows/testflight-on-comment.yml b/.github/workflows/testflight-on-comment.yml
index 12f57f0c..bc727bb5 100644
--- a/.github/workflows/testflight-on-comment.yml
+++ b/.github/workflows/testflight-on-comment.yml
@@ -71,7 +71,7 @@ jobs:
   deploy-testflight:
     needs: check-comment
     # Run on push to ios-tts branch OR when triggered by comment with approval
-    if: github.event_name == 'push' || needs.check-comment.outputs.should-deploy == 'true'
+    if: always() && (github.event_name == 'push' || needs.check-comment.outputs.should-deploy == 'true')
     runs-on: macos-latest-xlarge
     steps:
       - uses: actions/checkout@v4
@@ -168,10 +168,6 @@ jobs:
           [target.aarch64-apple-ios-sim.onnxruntime]
           rustc-link-search = ["${WORKSPACE}/frontend/src-tauri/onnxruntime-ios/onnxruntime.xcframework/ios-arm64-simulator"]
           rustc-link-lib = ["static=onnxruntime"]
-          
-          [target.x86_64-apple-ios.onnxruntime]
-          rustc-link-search = ["${WORKSPACE}/frontend/src-tauri/onnxruntime-ios/onnxruntime.xcframework/ios-arm64-simulator"]
-          rustc-link-lib = ["static=onnxruntime"]
           EOF
           
           echo "Generated cargo config:"
@@ -228,7 +224,7 @@ jobs:
             --apiIssuer ${{ secrets.APPLE_API_ISSUER }}
 
       - name: Comment on PR with success
-        if: success()
+        if: success() && github.event_name == 'issue_comment'
         uses: actions/github-script@v7
         with:
           script: |
@@ -240,7 +236,7 @@ jobs:
             });
 
       - name: Comment on PR with failure
-        if: failure()
+        if: failure() && github.event_name == 'issue_comment'
         uses: actions/github-script@v7
         with:
           script: |
diff --git a/frontend/src-tauri/build.rs b/frontend/src-tauri/build.rs
index ecad17e9..d860e1e6 100644
--- a/frontend/src-tauri/build.rs
+++ b/frontend/src-tauri/build.rs
@@ -1,33 +1,3 @@
 fn main() {
-    // iOS-specific build configuration for ONNX Runtime
-    #[cfg(target_os = "ios")]
-    {
-        // Get the path to the ONNX Runtime xcframework
-        let manifest_dir = std::env::var("CARGO_MANIFEST_DIR").unwrap();
-        let ort_dir = format!("{}/onnxruntime-ios", manifest_dir);
-        
-        // Check if building for simulator or device
-        let target = std::env::var("TARGET").unwrap_or_default();
-        let lib_path = if target.contains("sim") || target.contains("x86_64") {
-            format!("{}/onnxruntime.xcframework/ios-arm64_x86_64-simulator", ort_dir)
-        } else {
-            format!("{}/onnxruntime.xcframework/ios-arm64", ort_dir)
-        };
-        
-        // Tell cargo where to find the ONNX Runtime static library
-        println!("cargo:rustc-link-search=native={}", lib_path);
-        println!("cargo:rustc-link-lib=static=onnxruntime");
-        
-        // Link required iOS frameworks
-        println!("cargo:rustc-link-lib=framework=Foundation");
-        println!("cargo:rustc-link-lib=framework=Accelerate");
-        
-        // Set ORT_LIB_LOCATION for the ort crate
-        println!("cargo:rustc-env=ORT_LIB_LOCATION={}", ort_dir);
-        
-        // Rerun if the onnxruntime directory changes
-        println!("cargo:rerun-if-changed={}", ort_dir);
-    }
-    
     tauri_build::build()
 }
diff --git a/frontend/src-tauri/scripts/setup-ios-cargo-config.sh b/frontend/src-tauri/scripts/setup-ios-cargo-config.sh
index 7f5e09fe..8ec821ff 100755
--- a/frontend/src-tauri/scripts/setup-ios-cargo-config.sh
+++ b/frontend/src-tauri/scripts/setup-ios-cargo-config.sh
@@ -40,10 +40,6 @@ rustc-link-lib = ["static=onnxruntime"]
 rustc-link-search = ["${XCFRAMEWORK_DIR}/ios-arm64-simulator"]
 rustc-link-lib = ["static=onnxruntime"]
 
-[target.x86_64-apple-ios.onnxruntime]
-rustc-link-search = ["${XCFRAMEWORK_DIR}/ios-arm64-simulator"]
-rustc-link-lib = ["static=onnxruntime"]
-
 [env]
 ORT_LIB_LOCATION = "${XCFRAMEWORK_DIR}/ios-arm64"
 EOF
diff --git a/frontend/src-tauri/scripts/setup-ios-onnxruntime.sh b/frontend/src-tauri/scripts/setup-ios-onnxruntime.sh
index 88e0e491..26123f70 100755
--- a/frontend/src-tauri/scripts/setup-ios-onnxruntime.sh
+++ b/frontend/src-tauri/scripts/setup-ios-onnxruntime.sh
@@ -7,7 +7,7 @@ set -e
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 TAURI_DIR="$(dirname "$SCRIPT_DIR")"
-ORT_VERSION="${ORT_VERSION:-1.20.1}"
+ORT_VERSION="${ORT_VERSION:-1.22.2}"
 ORT_DIR="$TAURI_DIR/onnxruntime-ios"
 XCFRAMEWORK_DIR="$ORT_DIR/onnxruntime.xcframework"
 
diff --git a/frontend/src-tauri/src/tts.rs b/frontend/src-tauri/src/tts.rs
index bfd5ab4a..5c8fd8af 100644
--- a/frontend/src-tauri/src/tts.rs
+++ b/frontend/src-tauri/src/tts.rs
@@ -621,7 +621,7 @@ fn get_tts_models_dir() -> Result<PathBuf> {
         let data_dir = PathBuf::from(home).join("Documents").join("tts_models");
         return Ok(data_dir);
     }
-    
+
     #[cfg(not(target_os = "ios"))]
     {
         let data_dir = dirs::data_local_dir()
diff --git a/frontend/src/components/UnifiedChat.tsx b/frontend/src/components/UnifiedChat.tsx
index 1bd0ecc4..d63881fb 100644
--- a/frontend/src/components/UnifiedChat.tsx
+++ b/frontend/src/components/UnifiedChat.tsx
@@ -2676,6 +2676,7 @@ export function UnifiedChat() {
                   size="sm"
                   className="h-6 px-2 ml-2"
                   onClick={clearPlaybackError}
+                  aria-label="Dismiss TTS error"
                 >
                   <X className="h-4 w-4" />
                 </Button>
diff --git a/frontend/vite.config.ts b/frontend/vite.config.ts
index 01057f42..d317d231 100644
--- a/frontend/vite.config.ts
+++ b/frontend/vite.config.ts
@@ -13,6 +13,7 @@ export default defineConfig({
     }
   },
   server: {
+    // Bind to 0.0.0.0 so the iOS simulator can reach the dev server (dev-only).
     host: "0.0.0.0",
     port: 5173,
     strictPort: true

From 9d74727faaad86cb42aea253067f4b0c040ac799 Mon Sep 17 00:00:00 2001
From: Tony Giorgio <tonygiorgio@protonmail.com>
Date: Thu, 15 Jan 2026 16:01:33 -0600
Subject: [PATCH 08/11] fix(ios): store TTS models under Library/Caches

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
---
 frontend/src-tauri/src/tts.rs | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/frontend/src-tauri/src/tts.rs b/frontend/src-tauri/src/tts.rs
index 5c8fd8af..e8b78e9b 100644
--- a/frontend/src-tauri/src/tts.rs
+++ b/frontend/src-tauri/src/tts.rs
@@ -615,10 +615,14 @@ fn get_tts_models_dir() -> Result<PathBuf> {
     // On iOS, we need to use a different approach since dirs::data_local_dir() may not work
     #[cfg(target_os = "ios")]
     {
-        // On iOS, use the app's Documents directory which is accessible and persists
-        // NSHomeDirectory() + /Documents/tts_models
+        // On iOS, store models under Library/Caches so they're not user-visible (Files app)
+        // and won't be iCloud-backed.
         let home = std::env::var("HOME").context("Failed to get HOME directory on iOS")?;
-        let data_dir = PathBuf::from(home).join("Documents").join("tts_models");
+        let data_dir = PathBuf::from(home)
+            .join("Library")
+            .join("Caches")
+            .join("cloud.opensecret.maple")
+            .join("tts_models");
         return Ok(data_dir);
     }
 

From b3c283a5f35f90c472fab81a8ffcfcf8b01e4c85 Mon Sep 17 00:00:00 2001
From: Tony Giorgio <tonygiorgio@protonmail.com>
Date: Thu, 15 Jan 2026 18:36:35 -0600
Subject: [PATCH 09/11] ci: restore TestFlight workflow if conditions

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
---
 .github/workflows/testflight-on-comment.yml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/testflight-on-comment.yml b/.github/workflows/testflight-on-comment.yml
index bc727bb5..784cbdbc 100644
--- a/.github/workflows/testflight-on-comment.yml
+++ b/.github/workflows/testflight-on-comment.yml
@@ -71,7 +71,7 @@ jobs:
   deploy-testflight:
     needs: check-comment
     # Run on push to ios-tts branch OR when triggered by comment with approval
-    if: always() && (github.event_name == 'push' || needs.check-comment.outputs.should-deploy == 'true')
+    if: github.event_name == 'push' || needs.check-comment.outputs.should-deploy == 'true'
     runs-on: macos-latest-xlarge
     steps:
       - uses: actions/checkout@v4
@@ -224,7 +224,7 @@ jobs:
             --apiIssuer ${{ secrets.APPLE_API_ISSUER }}
 
       - name: Comment on PR with success
-        if: success() && github.event_name == 'issue_comment'
+        if: success()
         uses: actions/github-script@v7
         with:
           script: |
@@ -236,7 +236,7 @@ jobs:
             });
 
       - name: Comment on PR with failure
-        if: failure() && github.event_name == 'issue_comment'
+        if: failure()
         uses: actions/github-script@v7
         with:
           script: |

From f06e24290ff73b30c8e204d99438fcf1f0411735 Mon Sep 17 00:00:00 2001
From: Tony Giorgio <tonygiorgio@protonmail.com>
Date: Thu, 15 Jan 2026 19:14:23 -0600
Subject: [PATCH 10/11] chore(ios): remove unused setup-ios-onnxruntime script

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
---
 .../scripts/setup-ios-onnxruntime.sh          | 78 -------------------
 1 file changed, 78 deletions(-)
 delete mode 100755 frontend/src-tauri/scripts/setup-ios-onnxruntime.sh

diff --git a/frontend/src-tauri/scripts/setup-ios-onnxruntime.sh b/frontend/src-tauri/scripts/setup-ios-onnxruntime.sh
deleted file mode 100755
index 26123f70..00000000
--- a/frontend/src-tauri/scripts/setup-ios-onnxruntime.sh
+++ /dev/null
@@ -1,78 +0,0 @@
-#!/bin/bash
-# Setup ONNX Runtime for iOS builds
-# This script downloads pre-built ONNX Runtime xcframework from HuggingFace
-# or builds from source if needed.
-
-set -e
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-TAURI_DIR="$(dirname "$SCRIPT_DIR")"
-ORT_VERSION="${ORT_VERSION:-1.22.2}"
-ORT_DIR="$TAURI_DIR/onnxruntime-ios"
-XCFRAMEWORK_DIR="$ORT_DIR/onnxruntime.xcframework"
-
-echo "Setting up ONNX Runtime $ORT_VERSION for iOS..."
-echo "Target directory: $ORT_DIR"
-
-# Check if already downloaded
-if [ -d "$XCFRAMEWORK_DIR" ]; then
-    echo "ONNX Runtime xcframework already exists at $XCFRAMEWORK_DIR"
-    echo "To re-download, remove the directory first: rm -rf $ORT_DIR"
-    exit 0
-fi
-
-# Create directory
-mkdir -p "$ORT_DIR"
-
-# Download pre-built xcframework from HuggingFace
-# Repository: https://huggingface.co/csukuangfj/ios-onnxruntime
-HF_BASE_URL="https://huggingface.co/csukuangfj/ios-onnxruntime/resolve/main"
-
-echo "Downloading ONNX Runtime $ORT_VERSION xcframework from HuggingFace..."
-
-# Download the xcframework directory structure
-# The structure is:
-# onnxruntime.xcframework/
-#   Info.plist
-#   Headers/
-#     cpu_provider_factory.h
-#     onnxruntime_c_api.h
-#     onnxruntime_cxx_api.h
-#     onnxruntime_cxx_inline.h
-#   ios-arm64/
-#     onnxruntime.a
-#   ios-arm64_x86_64-simulator/
-#     onnxruntime.a
-
-mkdir -p "$XCFRAMEWORK_DIR/Headers"
-mkdir -p "$XCFRAMEWORK_DIR/ios-arm64"
-mkdir -p "$XCFRAMEWORK_DIR/ios-arm64_x86_64-simulator"
-
-echo "Downloading Info.plist..."
-curl -L -o "$XCFRAMEWORK_DIR/Info.plist" \
-    "$HF_BASE_URL/$ORT_VERSION/onnxruntime.xcframework/Info.plist"
-
-echo "Downloading headers..."
-for header in cpu_provider_factory.h onnxruntime_c_api.h onnxruntime_cxx_api.h onnxruntime_cxx_inline.h; do
-    curl -L -o "$XCFRAMEWORK_DIR/Headers/$header" \
-        "$HF_BASE_URL/$ORT_VERSION/onnxruntime.xcframework/Headers/$header"
-done
-
-echo "Downloading iOS arm64 static library (this may take a while)..."
-curl -L -o "$XCFRAMEWORK_DIR/ios-arm64/libonnxruntime.a" \
-    "$HF_BASE_URL/$ORT_VERSION/onnxruntime.xcframework/ios-arm64/onnxruntime.a"
-
-echo "Downloading iOS simulator static library (this may take a while)..."
-curl -L -o "$XCFRAMEWORK_DIR/ios-arm64_x86_64-simulator/libonnxruntime.a" \
-    "$HF_BASE_URL/$ORT_VERSION/onnxruntime.xcframework/ios-arm64_x86_64-simulator/onnxruntime.a"
-
-echo ""
-echo "ONNX Runtime xcframework downloaded successfully!"
-echo "Location: $XCFRAMEWORK_DIR"
-echo ""
-echo "Contents:"
-ls -la "$XCFRAMEWORK_DIR"
-echo ""
-echo "Static library sizes:"
-ls -lh "$XCFRAMEWORK_DIR/ios-arm64/libonnxruntime.a"
-ls -lh "$XCFRAMEWORK_DIR/ios-arm64_x86_64-simulator/libonnxruntime.a"

From a85a9f9fc6ca7cee96593253eab8e22c71782261 Mon Sep 17 00:00:00 2001
From: Tony Giorgio <tonygiorgio@protonmail.com>
Date: Thu, 15 Jan 2026 19:43:46 -0600
Subject: [PATCH 11/11] fix(ios): omit simulator slice when not built

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
---
 .../scripts/build-ios-onnxruntime.sh          | 44 ++++++++++++++++++-
 1 file changed, 42 insertions(+), 2 deletions(-)

diff --git a/frontend/src-tauri/scripts/build-ios-onnxruntime.sh b/frontend/src-tauri/scripts/build-ios-onnxruntime.sh
index fb1d2408..8ae0971b 100755
--- a/frontend/src-tauri/scripts/build-ios-onnxruntime.sh
+++ b/frontend/src-tauri/scripts/build-ios-onnxruntime.sh
@@ -161,6 +161,11 @@ echo "Skipping iOS simulator build (known ONNX Runtime CMake bug with libiconv)"
 echo "Device build is sufficient for TestFlight deployment"
 IOS_SIM_ARM64_LIB=""
 
+HAS_SIM_LIB=false
+if [ -n "$IOS_SIM_ARM64_LIB" ] && [ -f "$IOS_SIM_ARM64_LIB" ]; then
+    HAS_SIM_LIB=true
+fi
+
 # Create output directories
 echo ""
 echo "========================================"
@@ -169,14 +174,17 @@ echo "========================================"
 
 mkdir -p "${OUTPUT_DIR}"
 mkdir -p "${XCFRAMEWORK_DIR}/ios-arm64"
-mkdir -p "${XCFRAMEWORK_DIR}/ios-arm64-simulator"
 mkdir -p "${XCFRAMEWORK_DIR}/Headers"
 
+if [ "$HAS_SIM_LIB" = true ]; then
+    mkdir -p "${XCFRAMEWORK_DIR}/ios-arm64-simulator"
+fi
+
 # Copy the device library
 cp "$IOS_ARM64_LIB" "${XCFRAMEWORK_DIR}/ios-arm64/libonnxruntime.a"
 
 # Copy the simulator library (arm64 only for now)
-if [ -n "$IOS_SIM_ARM64_LIB" ] && [ -f "$IOS_SIM_ARM64_LIB" ]; then
+if [ "$HAS_SIM_LIB" = true ]; then
     cp "$IOS_SIM_ARM64_LIB" "${XCFRAMEWORK_DIR}/ios-arm64-simulator/libonnxruntime.a"
 else
     echo "Warning: No simulator library available"
@@ -194,6 +202,7 @@ if [ -d "include/onnxruntime/core/session" ]; then
 fi
 
 # Create Info.plist for xcframework
+if [ "$HAS_SIM_LIB" = true ]; then
 cat > "${XCFRAMEWORK_DIR}/Info.plist" << 'PLIST'
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
@@ -239,6 +248,37 @@ cat > "${XCFRAMEWORK_DIR}/Info.plist" << 'PLIST'
 </dict>
 </plist>
 PLIST
+else
+cat > "${XCFRAMEWORK_DIR}/Info.plist" << 'PLIST'
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>AvailableLibraries</key>
+    <array>
+        <dict>
+            <key>HeadersPath</key>
+            <string>Headers</string>
+            <key>LibraryIdentifier</key>
+            <string>ios-arm64</string>
+            <key>LibraryPath</key>
+            <string>libonnxruntime.a</string>
+            <key>SupportedArchitectures</key>
+            <array>
+                <string>arm64</string>
+            </array>
+            <key>SupportedPlatform</key>
+            <string>ios</string>
+        </dict>
+    </array>
+    <key>CFBundlePackageType</key>
+    <string>XFWK</string>
+    <key>XCFrameworkFormatVersion</key>
+    <string>1.0</string>
+</dict>
+</plist>
+PLIST
+fi
 
 echo ""
 echo "========================================"