chat_web_app/llm-fe/ios/README.md

Hesychia — iOS

Native Capacitor project for ai.hesychia.chat. Web UI comes from the CRA build/ output in the parent llm-fe/ package (synced with npx cap sync).

Broader Capacitor notes (env files, icons, QA, TestFlight): ../IOS.md.

Prerequisites

• macOS + Xcode 15+
• Node.js 20
• CocoaPods (pod --version)
• Open App.xcworkspace (not .xcodeproj)

Build the web bundle and sync

From the npm root (llm-fe/, one level up):

cd ..
npm ci
npm run build:mobile    # .env.mobile → react-scripts build → cap sync

Open in Xcode:

npm run ios:open
# or: npx cap open ios

Re-sync after changing web code (with an existing build/):

npm run ios:sync

Backend URLs are baked in at web-build time via ../.env.mobile (prod by default).

After cloning, if Pods are missing:

cd App
pod install

Run on a simulator / device

1. Open App/App.xcworkspace in Xcode.
2. Pick a simulator or a paired iPhone (Signing & Capabilities → your Team).
3. Product → Run (⌘R).

CLI (optional):

xcodebuild -workspace App/App.xcworkspace \
  -scheme App \
  -destination 'platform=iOS Simulator,name=iPhone 16' \
  build

Version before a store release

Edit target App → General, or App.xcodeproj build settings:

Field	Build setting	Rule
Version	MARKETING_VERSION	Keep in sync with ../package.json version + Android versionName
Build	CURRENT_PROJECT_VERSION	Integer; must increase for every TestFlight / App Store upload

Currently: version 0.1.0, build 1.

Signing

Do not commit .p12, .mobileprovision, or export option files with secrets.

Debug / simulator: Automatic signing with a personal team is enough.

Distribution: App Store Connect + distribution certificate + profile — credentials live outside this repo. CI/TestFlight automation is a follow-on ticket.

Useful paths

Path	Purpose
App/App/AppDelegate.swift	Disables WKWebView rubber-band bounce
App/App/Info.plist	Display name Hesychia, version keys
App/App/Assets.xcassets	App icon + splash (regenerate via npm run assets:generate)
App/Podfile / Podfile.lock	CocoaPods (commit lockfile; Pods/ is gitignored)