docs(qa): iPhone, Watch and Mac beta tester guide

[mikib0]

Beta tester guide covering all three Apple surfaces: iPhone, Mac and Apple Watch.

Two things surfaced while writing this:

• The watch app is not in the TestFlight build. apps/swift/project.yml:128
  deliberately excludes PackRat-Watch from distribution builds because it has
  no app icons, which App Store validation rejects (error 90391). The guide
  therefore routes watch testing through the paired-simulator harness. Adding
  watch app icons and re-adding that dependency would let the watch app ship to
  TestFlight normally.

• scripts/watch-sync-smoke.ts has stale bundle IDs. Lines 23-24 use
  com.andrewbierman.packrat and ...packrat.watchkitapp, but the project
  builds com.andrewbierman.packrat.swift and ...packrat.swift.watchkitapp
  (project.yml:138,166). The script will fail to find the installed apps until
  that is fixed. The guide warns testers about this failure mode.

The guide also asks testers to confirm a suspected bug: WatchChecklistToggle
holds local @State with no write-back to WatchConnectivityStore
(Sources/PackRatWatch/PackRatWatchApp.swift:253-267), so checklist toggles
likely neither persist nor reach the phone. Flagged as "please confirm" rather
than asserted, since it is a code read and was not verified at runtime.

Screens behind disabled feature flags (Feed, Shopping List, Wildlife, Trails,
Pack Insights) are called out as expected-missing so testers do not chase them.

Summary by CodeRabbit

• Documentation
  • Added a comprehensive beta testing guide for Apple platforms.
  • Covers iPhone, Mac, and Apple Watch workflows, including installation, authentication, offline use, synchronization, multi-window behavior, and issue reporting.
  • Documents expected behavior and failure cases for key app features.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 43ee0dac-61d2-48a8-8e5e-47267acc9d24

📥 Commits

Reviewing files that changed from the base of the PR and between c3a766b and 2304529.

📒 Files selected for processing (1)

• docs/qa/apple-platforms-beta-test-plan.md

---

Walkthrough

The pull request adds a comprehensive Apple-platform beta test plan. It covers iPhone, Mac, and Apple Watch installation, core features, offline behavior, synchronization, accessibility checks, and issue reporting.

Changes

Apple platform beta coverage

Layer / File(s)	Summary
Scope and iPhone workflows docs/qa/apple-platforms-beta-test-plan.md	Defines TestFlight setup and iPhone checks for authentication, packs, trips, weather, assistant behavior, catalogs, guides, offline operation, synchronization, and appearance.
Mac workflows docs/qa/apple-platforms-beta-test-plan.md	Defines Mac checks for installation, responsive layouts, multiple windows, navigation, editing, menus, shortcuts, offline operation, and synchronization.
Apple Watch workflows docs/qa/apple-platforms-beta-test-plan.md	Defines Apple Watch checks for installation, authentication, navigation, pack synchronization, Trail Ready, weather, Trail Report, and offline submissions.
Issue reporting docs/qa/apple-platforms-beta-test-plan.md	Defines GitHub issue reporting instructions and Apple Watch screenshot guidance.

Estimated code review effort: 2 (Simple) | ~10 minutes

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch worktree-qa-apple-handoff

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}