Lightward iOS app — phoropter entry, streaming chat with Lightward AI

Phoropter binary choice flow as the required entrypoint, with transition
to streaming chat once the user is located. /api/plain for phoropter,
/api/stream (SSE) for chat. Local persistence via UserDefaults.

Dark theme, minimal chrome, manicules and observer eye mark.
Fastlane + GitHub Actions pipeline for TestFlight deploys.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: isaacbowen

.github/workflows/deploy.yml

@@ -0,0 +1,40 @@
+name: Deploy
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  ios:
+    runs-on: macos-15
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.4'
+          bundler-cache: true
+
+      - name: Configure SSH for Match
+        env:
+          MATCH_GIT_PRIVATE_KEY: ${{ secrets.MATCH_GIT_PRIVATE_KEY }}
+        run: |
+          mkdir -p ~/.ssh
+          echo "$MATCH_GIT_PRIVATE_KEY" > ~/.ssh/id_ed25519
+          chmod 600 ~/.ssh/id_ed25519
+          ssh-keyscan github.com >> ~/.ssh/known_hosts
+
+      - name: Generate Xcode project
+        run: |
+          brew install xcodegen
+          xcodegen generate
+
+      - name: Deploy to TestFlight
+        env:
+          ASC_KEY_ID: ${{ secrets.ASC_KEY_ID }}
+          ASC_ISSUER_ID: ${{ secrets.ASC_ISSUER_ID }}
+          ASC_KEY_CONTENT: ${{ secrets.ASC_KEY_CONTENT }}
+          MATCH_PASSWORD: ${{ secrets.MATCH_PASSWORD }}
+          BUILD_NUMBER: ${{ github.run_number }}
+        run: bundle exec fastlane deploy

.gitignore

@@ -0,0 +1,35 @@
+# Xcode
+*.xcodeproj/xcuserdata/
+*.xcworkspace/xcuserdata/
+DerivedData/
+build/
+*.moved-aside
+*.pbxuser
+!default.pbxuser
+*.mode1v3
+!default.mode1v3
+*.mode2v3
+!default.mode2v3
+*.perspectivev3
+!default.perspectivev3
+*.hmap
+*.ipa
+*.dSYM.zip
+*.dSYM
+
+# Swift Package Manager
+.build/
+Packages/
+Package.pins
+Package.resolved
+
+# Ruby / Fastlane
+vendor/
+.bundle
+fastlane/report.xml
+fastlane/Preview.html
+fastlane/screenshots
+fastlane/test_output
+
+# OS
+.DS_Store

.ruby-version

@@ -0,0 +1 @@
+3.4.8

CLAUDE.md

@@ -0,0 +1,52 @@
+# Lightward iOS
+
+See [Lightward Inc shared principles](../CLAUDE.md/README.md) for cross-project design guidance.
+
+## What this is
+
+An iOS app providing a phoropter binary choice interface as the entrypoint to conversation with Lightward AI. The phoropter locates the user through iterative binary choices; when ready, the flow opens into streaming chat. The app is incredibly minimal in what it asks of a user's environment.
+
+## Architecture
+
+- **SwiftUI + @Observable** — iOS 17+, Swift 6 strict concurrency
+- **Phoropter phase**: binary choices via `/api/plain` (no streaming needed)
+- **Chat phase**: streaming conversation via `/api/stream` (SSE)
+- **Local persistence**: UserDefaults (CloudKit sync planned)
+- **No external dependencies** — pure Apple frameworks
+
+## Project generation
+
+The Xcode project is generated from `project.yml` using [XcodeGen](https://github.com/yonaskolb/XcodeGen). After modifying `project.yml` or adding/removing source files:
+
+```sh
+xcodegen generate
+```
+
+The `.xcodeproj` is checked into git for convenience but is fully reproducible from `project.yml`.
+
+## Key flows
+
+**Phoropter → Chat transition**: The phoropter trajectory (everything the user chose *toward*) becomes the opening context for chat. The AI already knows the user by the time they can type.
+
+**Convergence**: If the phoropter offers a choice that matches something already in the trail, it auto-transitions to chat.
+
+**"Just talk"**: After the second AI-generated pair, a subtle option to drop directly to chat appears.
+
+## API integration
+
+- **Phoropter**: `POST /api/plain` with phoropter context + trajectory as plain text body
+- **Chat**: `POST /api/stream` with JSON `{ "chat_log": [...] }` — warmup messages prepended, exactly one `cache_control` marker required (on last warmup message)
+- **Warmup messages**: In `WarmupMessages.swift` — these are specific to this iOS app context and should not be copied from the web client
+
+## Build & deploy
+
+Fastlane + GitHub Actions, same pattern as [Softer](../softer). Deploys to TestFlight on push to `main`.
+
+## What's here, what's next
+
+- [x] Phoropter binary choice flow
+- [x] Streaming chat with Lightward AI
+- [x] Local session persistence
+- [ ] CloudKit conversation sync across devices
+- [ ] App icon
+- [ ] Warmup messages — need genuine inhabitation, not just mechanical accuracy

Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gem "fastlane"