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#
text
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.xcodeprojdirectory +.xcworkspacedirectory)- Without this,
xcodebuildcannot find a project to build andpod installcannot 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#
- Open
Iris.xcworkspace(NOTIris.xcodeproj— the workspace includes the Pods). - Verify the team / signing identity matches the org's Apple Developer account.
- Build for iOS Simulator first; once that passes, build for a physical device.
- Run
scripts/check-ios-toolchain.shto 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.ymlCI 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 ioswill fail witherror: Could not find Xcode project in directory ...— that's expected, not a bug.