Apple Production

This is the operational checklist for taking the native Apple app family from the repo to Apple’s stores. The repo can prepare the Xcode project, metadata, and CI wiring; Apple Developer, App Store Connect, signing, TestFlight review, and production release still require account access on macOS.

Local readiness

Run this from the repository root:
npm run apple:check
apple:check verifies the native SwiftUI project structure, XcodeGen spec, device-family targets, privacy manifest, asset catalog, metadata seed, and native Apple GitHub workflow.

Xcode project

On macOS with Xcode and XcodeGen installed:
npm run apple:generate
This generates:
apps/apple/EverythingApple.xcodeproj
The generated project is intentionally ignored by git; apps/apple/project.yml is the source of truth.

Builds

On macOS:
npm run apple:build:ios
npm run apple:build:mac
npm run apple:build:watch
npm run apple:build:tv
npm run apple:build:vision
The GitHub workflow .github/workflows/apple-native.yml can build any one scheme manually on a macOS runner. Pushes to main only build the default native iOS scheme when repository variable APPLE_NATIVE_CI_ENABLED is set to true.

App Store Connect records

Seed product-page copy from:
apps/apple/Store/app-store-metadata.json
Start with:
Name: Everything
Primary bundle ID: co.sapientic.everything
SKU: co.sapientic.everything
Primary platform: iOS
Then add native platform records as targets become signing-ready:
  • macOS: co.sapientic.everything.macos
  • watchOS: co.sapientic.everything.watch
  • tvOS: co.sapientic.everything.tvos
  • visionOS: co.sapientic.everything.vision

Required GitHub settings

Set this repository variable only when main-branch native Apple builds should run:
APPLE_NATIVE_CI_ENABLED=true

Submission

Before sending builds to App Review, complete screenshots, age rating, privacy nutrition labels, export compliance, review notes, signing, and TestFlight external testing information in App Store Connect.