iOS App (#99)

closes #21Reviewed-on: #99
2026-08-03 12:14:21 -07:00
parent 4501ee8f3d
commit 5be66dbaa7
74 changed files with 1011 additions and 56 deletions
@@ -0,0 +1,89 @@
+# 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`](../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):
+
+```bash
+cd ..
+npm ci
+npm run build:mobile    # .env.mobile → react-scripts build → cap sync
+```
+
+Open in Xcode:
+
+```bash
+npm run ios:open
+# or: npx cap open ios
+```
+
+Re-sync after changing web code (with an existing `build/`):
+
+```bash
+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:
+
+```bash
+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):
+
+```bash
+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) |