# iris/mobile — Missing iOS .xcodeproj

**Status:** the `ios/` directory has the Swift source (AppDelegate,
Info.plist, the `Iris/` target dir with all of the iOS source files,
the Pods directory, the Podfile), but no `.xcodeproj` to bind those
files into an Xcode-buildable target. Closes #57.

## What's present

```
apps/iris/mobile/ios/
├── Iris/              # main iOS target source
│   ├── AppDelegate.swift
│   ├── Info.plist
│   ├── Iris.entitlements
│   ├── LaunchScreen.storyboard
│   ├── Assets.xcassets/
│   ├── Intents/
│   ├── LiveActivities/
│   ├── NativeModules/
│   └── Services/
├── IrisIntents/        # SiriKit intent extension target
├── IrisWidgets/        # WidgetKit extension target
├── Podfile
├── Pods/               # gitignored; regenerated by `pod install`
└── build/              # gitignored
```

## What's missing

- `apps/iris/mobile/ios/Iris.xcodeproj/project.pbxproj` (and the
  surrounding `.xcodeproj` directory + `.xcworkspace` directory)
- Without this, `xcodebuild` cannot find a project to build and
  `pod install` cannot link Pods into a target.

## Generate

Two paths, in order of preference:

### 1. React Native CLI init + source port (recommended)

```bash
RN_VERSION="$(node -e "console.log(require('./apps/iris/mobile/package.json').dependencies['react-native'])")"
npx @react-native-community/cli@latest init Iris \
  --version "$RN_VERSION" \
  --directory /tmp/iris-ios-scaffold

# Copy the generated .xcodeproj and .xcworkspace into our tree
cp -r /tmp/iris-ios-scaffold/ios/Iris.xcodeproj apps/iris/mobile/ios/
cp -r /tmp/iris-ios-scaffold/ios/Iris.xcworkspace apps/iris/mobile/ios/

# Open it in Xcode and:
#   a) Add the IrisIntents target (File → New → Target → Intents Extension)
#   b) Add the IrisWidgets target (File → New → Target → Widget Extension)
#   c) For each, drag the existing Iris/, IrisIntents/, IrisWidgets/
#      source files into the matching target's "Compile Sources" build phase
#   d) Update the bundle identifier in Build Settings → Packaging →
#      Product Bundle Identifier to match the existing Info.plist
#         (CFBundleIdentifier in apps/iris/mobile/ios/Iris/Info.plist)

rm -rf /tmp/iris-ios-scaffold
cd apps/iris/mobile/ios && pod install
```

### 2. Hand-roll via the `xcodeproj` Ruby gem

If you need to script the generation (CI doesn't have Xcode UI to
add the extension targets):

```bash
gem install xcodeproj  # requires Ruby 3.x — see docs/runbooks/ios-toolchain.md

# scripts/generate-iris-xcodeproj.rb is the templated generator;
# add it the next time this needs to happen via CI.
```

The `xcodeproj` gem can generate the full PBX tree programmatically.
For three-target apps like iris (main + Intents extension + Widgets
extension), this is doable in ~150 lines of Ruby. Until that
generator script exists, path 1 (init + manual extension wiring) is
the only working option.

## After generation

1. Open `Iris.xcworkspace` (NOT `Iris.xcodeproj` — the workspace
   includes the Pods).
2. Verify the team / signing identity matches the org's Apple
   Developer account.
3. Build for iOS Simulator first; once that passes, build for a
   physical device.
4. Run `scripts/check-ios-toolchain.sh` to confirm the host
   toolchain is healthy.

## Until the xcodeproj lands

- `pnpm typecheck` (`npx tsc --noEmit`) is the only working dev loop.
- The `mobile-build-smoke.yml` CI workflow targets veritas/mobile
  (which is a working bare RN app) rather than iris/mobile. Do not
  add iris/mobile to that workflow until the xcodeproj is in place.
- `pnpm ios` will fail with
  `error: Could not find Xcode project in directory ...` — that's
  expected, not a bug.
