Skip to content

iOS build handoff: guide, CLAUDE.md, iOS ignore rules - #76

Merged
nicglazkov merged 1 commit into
mainfrom
docs/ios-handoff
Jul 29, 2026
Merged

iOS build handoff: guide, CLAUDE.md, iOS ignore rules#76
nicglazkov merged 1 commit into
mainfrom
docs/ios-handoff

Conversation

@nicglazkov

Copy link
Copy Markdown
Owner

Prepares the repo to hand off to a macOS session for the iOS build.

Findings from the readiness check: the shared Kotlin module is already iOS-ready. iOS targets are declared, and every expect has an iOS actual in composeApp/src/iosMain/ (MainViewController, Darwin HTTP client, open-URL, launch-navigation, back-handling are real; Map/push/App-Check are intentional stubs). The only missing pieces are inherently macOS: the Xcode project and three native integrations.

This PR (docs/config only, no code or build change):

  • iosApp/README.md: complete build + handoff guide, incl. the state table, Xcode project setup with the framework-embed build phase, the Swift entry files, and step-by-step for the MapKit map, FCM/APNs push, and App Check.
  • CLAUDE.md: orients a fresh Claude session on the new machine (PR workflow, docs voice, secret hygiene, gcloud project pinning, and the noreply-email push requirement).
  • .gitignore: iOS/Xcode secrets and state (GoogleService-Info.plist, DerivedData, xcuserdata, Pods, Config.xcconfig).

Prepares the repo for the macOS/iOS build session:
- iosApp/README.md: full build + handoff guide (state table, Xcode project
  setup with the framework-embed build phase and Swift entry files, the three
  native integrations to implement (MapKit map, FCM/APNs push, App Check), and
  the secrets/accounts the Mac provides).
- CLAUDE.md: project orientation and conventions (PR workflow, docs voice,
  never-commit-secrets, gcloud project pinning, and the noreply-email push
  requirement that would otherwise bite on a new machine).
- .gitignore: ignore iOS/Xcode secrets and state (GoogleService-Info.plist,
  DerivedData, xcuserdata, Pods, Config.xcconfig).

No code or build changes; shared Kotlin already compiles for iOS with all
expect/actual actuals present.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014xbfpFLSceHGbpCVz2qBGG
@nicglazkov
nicglazkov merged commit f0a2dd2 into main Jul 29, 2026
3 checks passed
@nicglazkov
nicglazkov deleted the docs/ios-handoff branch July 29, 2026 08:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant