Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Sync develop → main: 1.0.1 docs + screenshot tooling (release after App Store approval)#72

Merged
Saqoosha merged 2 commits into
mainfrom
develop
May 19, 2026
Merged

Sync develop → main: 1.0.1 docs + screenshot tooling (release after App Store approval)#72
Saqoosha merged 2 commits into
mainfrom
develop

Conversation

@Saqoosha

Copy link
Copy Markdown
Owner

⚠️ Do not merge until 1.0.1 build 11 is approved + live on the App Store

This PR exists to bring main up to develop after 1.0.1 build 11 ships, so the production user manual at https://saqoosha.github.io/HDZap/ describes features users can actually find on the App Store. Merging earlier would publish docs that talk about TTS countdown / bridge toggle / "Last lap!" cue while users only have access to 1.0.0 build 9 — confusing and arguably misleading.

No iOS build, no MARKETING_VERSION bump, no new TestFlight upload — just a docs + DEBUG-tooling promote.

What's in this sync

Two squashed commits, both already on develop:

#70 — App Store screenshot capture tooling (DEBUG-only)4bbec4f

  • New seedForScreenshot(…) methods on LapTimer, BluetoothManager, RaceHistoryStore, gated by #if DEBUG.
  • Launch args -screenshotTimer / -screenshotHistory reproduce the exact App Store screenshot state in the iOS Simulator.
  • New docs/screenshot-capture.md documents the full workflow.
  • Zero production impact: every new path is compiled out of Release builds.

#71 — Document TTS countdown + bridge toggle in user manualde08a54

  • Section 5 step 3: tell first-time users to flip Use bridge on before drilling into the M5StickS3 row.
  • Section 10 → App → Lap announcer (Audio): new "Count down final seconds" toggle + "Start at" stepper + "Last lap!" / 「ファイナルラップです」 cue notes.
  • Section 10 → Device → Use bridge: new H3 documenting the master switch above the existing M5StickS3 entry; M5StickS3 / Goggle pairing / OSD layout entries now note "Only visible when Use bridge is on".
  • Mirrored in en.md and ja.md.

Diff summary

 app/HDZap/HDZapApp.swift                |  14 ++
 app/HDZap/Models/BluetoothManager.swift |  35 +++++
 app/HDZap/Models/LapTimer.swift         |  47 +++++++
 app/HDZap/Models/RaceHistoryStore.swift |  22 +++
 app/HDZap/Views/TimerView.swift         |  75 ++++++++++
 docs/manual/en.md                       |  22 ++-
 docs/manual/ja.md                       |  22 ++-
 docs/screenshot-capture.md              | 233 ++++++++++++++++++++++++++++++++
 8 files changed, 458 insertions(+), 12 deletions(-)

Release procedure

  1. Wait for App Store status on 1.0.1 build 11 to flip to Ready for Sale / Released.
  2. Mark this PR as ready for review (un-draft).
  3. Merge with merge commit (--merge, not squash), matching the existing develop → main release pattern (Release 1.0.1 (build 10) #66, Release 1.0.1 build 11 #69).
  4. Web Flasher CI on main rebuilds and redeploys:
  5. No additional tag — the existing v1.0.1+build11 tag stays where it is (it pins the original cut, not this docs catch-up).

Test plan

Saqoosha and others added 2 commits May 18, 2026 15:29
- Seed mode in LapTimer, BluetoothManager, and RaceHistoryStore that
  pre-populates lap data + flight-battery telemetry + race history when
  the app is launched with -screenshotTimer or -screenshotHistory.
- TimerView hooks the launch args to refresh metricsSnapshot and present
  the history sheet automatically.
- All seed code is gated behind #if DEBUG so Release builds never see it
  and the App Store binary is unaffected.
- docs/screenshot-capture.md documents the end-to-end workflow:
  simulator boot, status bar override, launch args, capture, ASC upload,
  and how to tweak the seed values for future UI changes.

Background: 1.0.1+build11 needed fresh App Store screenshots because the
session-bar readouts grew. Captured 01-timer + 02-history per locale from
iPhone 16 Plus sim and reused the composite shot 3 from v1.0. This commit
preserves the tooling so the next release that touches visible UI can
regenerate in minutes instead of rebuilding the seed code by hand.

Co-authored-by: Claude Opus 4.7 <[email protected]>
Catches the manual up with the 1.0.1 features that have visible
Settings surfaces, plus the workflow change they imply:

- **Section 5 — Pairing the M5StickS3**: new step 3 telling first-time
  users to flip **Use bridge** on before drilling into the M5StickS3
  row (it's hidden on a fresh install until the toggle goes on).
- **Section 10 — App → Lap announcer (Audio)**: new "Count down final
  seconds" toggle + "Start at" stepper (5–15 s, default 10) for the
  spoken countdown ("ten, nine, ..." / "じゅう、きゅう...").
  The automatic "Last lap!" / "ファイナルラップです" cue at
  remaining = 0 is noted on the existing "Announce lap times" entry.
- **Section 10 — Device → Use bridge**: new H3 above the existing
  M5StickS3 entry, documenting the master switch that gates the
  M5StickS3 / Goggle pairing / OSD layout drilldowns. Off by default
  on fresh installs (no Bluetooth permission prompt for users who
  don't own a bridge); existing users keep it on after upgrading.
- The three drilldown entries (M5StickS3, Goggle pairing, OSD layout)
  now note "Only visible when **Use bridge** is on" so the doc lines
  up with what users actually see in Settings.

Mirrored in en.md and ja.md.

Co-authored-by: Claude Opus 4.7 <[email protected]>
@coderabbitai

coderabbitai Bot commented May 18, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: c7253315-9af9-4298-993b-d92228b102b2

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch develop

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

Comment @coderabbitai help to get the list of available commands and usage tips.

@Saqoosha Saqoosha marked this pull request as ready for review May 19, 2026 00:38
@Saqoosha Saqoosha merged commit c1883db into main May 19, 2026
5 checks passed
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