Skip to content
9 changes: 9 additions & 0 deletions History/2026-11-02.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,3 +12,12 @@ Prepared Third Roll marketing, support and development privacy copy for free HTT

## 18:46 - Track scoring changes in site publication
Added the scoring source to the Pages workflow triggers so rule-table validation and publication also run after engine scoring changes.

## 22:50 - Update versioned iOS release records
Added checked version-specific 1.0 notes, bound the declared bundle identity to native configuration, and recorded the verified public-site deployment while preserving signed and store acceptance gates.

## 22:54 - Reinspect native privacy packaging
Verified the retained unsigned archive and all eleven manifest records, inventoried locked SDKs, and documented declaration decisions that still require signed-device evidence.

## 22:57 - Prepare English App Store metadata
Filled the listing and copy sources, checked current field limits and public URLs, and recorded claim evidence, optional-feature decisions and the unresolved store contact/acceptance requirements.
2 changes: 2 additions & 0 deletions History/2026-11-03.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
## 00:32 EST - Update combined release preparation from main
Integrated PR #98, documented explicit support-report URL transmission, and revalidated the combined release records without changing app source or test flow.
39 changes: 36 additions & 3 deletions apps/mobile/APP-STORE.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,23 +12,42 @@ The repository maintainer owns implementation, repeatable checks and evidence co

Use the existing Expo/React Native app and shared TypeScript engine. The first release has one local human, zero to three AI opponents, mobile presets of five/six/eight/ten dice and English. [#39](https://github.com/hemsoft-dev/yahtzee/issues/39) freezes the rules: Castle is two distinct triples, All of a Kind needs the whole hand to match, and there is no dedicated six-of-a-kind category.

The first release is free and available in all storefronts except China mainland. It excludes accounts, remote multiplayer, cloud scores/sync, analytics, ads, purchases, subscriptions, Game Center, widgets, Watch and the Android release. It targets iOS 17, supports iPhone/iPad and automatic orientation/appearance, and uses version 1.0.0/build 1. The bundle identifier is `com.hemsoft.thirdroll`. Creating the App Store record is what confirms the name is available.
The first release is planned to be free and available in all storefronts except China mainland. It excludes accounts, remote multiplayer, cloud scores/sync, analytics, ads, purchases, subscriptions, Game Center, widgets, Watch and the Android release. It targets iOS 17, supports iPhone/iPad and automatic orientation/appearance, and uses version 1.0.0/build 1. The bundle identifier is `com.hemsoft.thirdroll`. Creating the App Store record is what confirms the name is available.

## Repository preparation delivered

The shared UI/rules/Windows work landed in [#55](https://github.com/hemsoft-dev/yahtzee/pull/55). The native foundation landed in [#57](https://github.com/hemsoft-dev/yahtzee/pull/57), merge `0e3f2fec20148a0f09c14874fae6fe7efe798e60`. Its reviewed source `86011d88d87b264e7b3b09011527842321de1c2b` passed [unsigned simulator qualification](https://github.com/hemsoft-dev/yahtzee/actions/runs/36795531946) across five/six/eight/ten dice, solo/three AI, acknowledged cold resume, largest text, corrupt-data preservation and explicit reset/relaunch. The phone-six group passed a fresh failed-group rerun; its original cold-resume navigation miss remains retained. No existing state-changing tap was replayed.

The native app also includes Help, local history, preview-only optional diagnostics and original development icon/launch artwork. [Storage contracts](../../docs/mobile-offline.md), [native qualification](../../docs/native-simulator.md), [privacy observations](../../docs/mobile-privacy-audit.md) and [asset provenance](assets/README.md) record the limits. The source-built FileSystem resource and aggregate privacy manifests pass packaging checks, not legal or traffic acceptance.

Release records landed in [#56](https://github.com/hemsoft-dev/yahtzee/pull/56). The [unpublished website](https://github.com/hemsoft-dev/yahtzee/pull/58), [alpha-channel rejection](https://github.com/hemsoft-dev/yahtzee/pull/59) and [bounded PNG validation](https://github.com/hemsoft-dev/yahtzee/pull/60) are delivered repository preparation. [Draft capture automation](https://github.com/hemsoft-dev/yahtzee/pull/61) is merged preparation; accepted store screenshots remain pending. Fictional scenes are not played-game evidence or accepted store images.
Release records landed in [#56](https://github.com/hemsoft-dev/yahtzee/pull/56). The [initial website preview](https://github.com/hemsoft-dev/yahtzee/pull/58), [alpha-channel rejection](https://github.com/hemsoft-dev/yahtzee/pull/59) and [bounded PNG validation](https://github.com/hemsoft-dev/yahtzee/pull/60) are delivered repository preparation. [Draft capture automation](https://github.com/hemsoft-dev/yahtzee/pull/61) is merged preparation; accepted store screenshots remain pending. Fictional scenes are not played-game evidence or accepted store images.

This records source delivery, not a signed release candidate. Live workflow outcomes and recovery receipts belong to the linked PRs; a later failed run is not erased by an earlier pass.

The release scope and name are decided in [#39](https://github.com/hemsoft-dev/yahtzee/issues/39), which records a conflict screen, not legal clearance. The MIT license is not trademark clearance.

## Current public-site evidence

[PR #100](https://github.com/hemsoft-dev/yahtzee/pull/100) merged at
`754d0f9806cf04d6c45b96ebee957cef444c0a17`. Its
[Pages deployment](https://github.com/hemsoft-dev/yahtzee/actions/runs/41574244090)
passed. On November 2, 2026 EST, a fresh unauthenticated Chromium context and
independent HTTPS requests verified 200 responses for
[marketing](https://hemsoft-dev.github.io/yahtzee/),
[support](https://hemsoft-dev.github.io/yahtzee/support.html) and
[privacy](https://hemsoft-dev.github.io/yahtzee/privacy.html), working navigation
and both unchanged screenshot assets. HTTPS is enforced. No store download is
advertised. App Store Connect has not been accessed in this session.

The reviewed source `dee3455` passed
[unsigned qualification attempt 2](https://github.com/hemsoft-dev/yahtzee/actions/runs/41558133101/attempts/2).
Phone-six and tablet-eight required the single authorized fresh failed-job
rerun; original device-unreachable and score-acknowledgment failures remain
retained. This is source evidence, not a signed release candidate.

## Candidate mapping and checks

[release/candidate.json](release/candidate.json) is an explicitly incomplete 1.0.0, build 1 proposal, separate from Windows 0.1.0. It links the [iOS changelog](CHANGELOG.md), [TestFlight notes](release/testflight-notes.md), [listing sources](release/metadata/en-US/listing.json) and [screenshot manifest](release/screenshots.json).
[release/candidate.json](release/candidate.json) is an explicitly incomplete 1.0.0, build 1 proposal, separate from Windows 0.1.0. It includes the approved bundle identity and [versioned 1.0 notes](release/notes/1.0.0.md). The checker rejects a version-note path for another marketing version and verifies the tracked source bytes in release mode. It links the [iOS changelog](CHANGELOG.md), [TestFlight notes](release/testflight-notes.md), [listing sources](release/metadata/en-US/listing.json) and [screenshot manifest](release/screenshots.json).

From the repository root:

Expand All @@ -53,6 +72,20 @@ The tracked screenshot JSON is a scene plan, not a capture receipt. Generate the

Retain the accepted JSON beside the archive and sanitized QA receipts. Its iOS tag must point to the source SHA. On public release, verify the matching GitHub tag/release, public App Store version and dated changelog entry. No automatic release/changelog workflow currently publishes these files; do not duplicate Unreleased entries in generated notes if one is introduced.

## Session authority and store boundary

On November 2 Franz authorized PR #100's merge and website publication only.
Every later Yahtzee PR remains under a merge hold until he explicitly confirms
PR #98 has merged. Continue reviews and checks while held. This session never
accesses App Store Connect, uploads, submits, invites testers or publishes an
app. Keep the store record, signing, TestFlight, export/legal attestations and
post-store smoke checks unchecked until separate evidence exists.

On November 3 Franz confirmed PR #98 had merged and released the hold for
combined PR #104. Update it from main, require fresh exact-head SFL and green
CI, then merge normally and notify him immediately so PR #107 can follow.
This does not authorize App Store Connect access or submission.

## Editable content

The local metadata layout is Fastlane-style, but no Fastlane/EAS upload is configured. [description.txt](release/metadata/en-US/description.txt), [review_notes.txt](release/metadata/en-US/review_notes.txt) and [release_notes.txt](release/metadata/en-US/release_notes.txt) are clearly marked drafts. Null listing fields are unresolved decisions, not accepted defaults. Never upload these templates unchanged. First-release What's New may be absent in App Store Connect; do not require an updates-only field for the initial version.
Expand Down
4 changes: 3 additions & 1 deletion apps/mobile/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,11 @@ No iOS version has shipped. Windows and web changes have their own release histo

- Separate offline native gameplay with acknowledged active-game saves, cold resume, explicit discard/reset, damaged-save recovery, local history and rankings. Repository implementation landed in [#57](https://github.com/hemsoft-dev/yahtzee/pull/57); signed-device acceptance remains open in [#41](https://github.com/hemsoft-dev/yahtzee/issues/41).
- iPhone/iPad layouts, scalable native text, System/Light/Dark appearance, Help and optional preview-before-share diagnostics. Unsigned simulator evidence is linked in [#57](https://github.com/hemsoft-dev/yahtzee/pull/57), not physical-device/VoiceOver acceptance.
- Original development icon/launch artwork and source-bound unsigned simulator CI with gameplay, storage-recovery and privacy-manifest packaging checks. Brand approval, signing and release evidence remain open in [#45](https://github.com/hemsoft-dev/yahtzee/issues/45) and [#46](https://github.com/hemsoft-dev/yahtzee/issues/46).
- Original development icon/launch artwork and source-bound unsigned simulator CI with gameplay, storage-recovery and privacy-manifest packaging checks. Identity is decided in [#39](https://github.com/hemsoft-dev/yahtzee/issues/39); signing and release evidence remain open in [#45](https://github.com/hemsoft-dev/yahtzee/issues/45) and [#46](https://github.com/hemsoft-dev/yahtzee/issues/46).
- Draft release records, editable listing sources and a fail-closed candidate check. Tracked in [#47](https://github.com/hemsoft-dev/yahtzee/issues/47).

- Public marketing, support and development-app privacy pages, with privacy-safe native setup/Help captures. Delivered in [#100](https://github.com/hemsoft-dev/yahtzee/pull/100).

### Changed

- The app is now Third Roll, with bundle identifier `com.hemsoft.thirdroll`. The two whole-hand categories are labeled All of a Kind, with unchanged scores and internal IDs. Decided in [#39](https://github.com/hemsoft-dev/yahtzee/issues/39).
Expand Down
5 changes: 3 additions & 2 deletions apps/mobile/release/candidate.json
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
"tag": "ios/v1.0.0",
"appStoreVersion": "1.0.0",
"appStoreId": null,
"bundleIdentifier": null,
"bundleIdentifier": "com.hemsoft.thirdroll",
"archiveSha256": null,
"screenshotManifestSha256": null,
"testFlightBuildId": null,
Expand All @@ -16,5 +16,6 @@
"changelog": "CHANGELOG.md",
"testNotes": "release/testflight-notes.md",
"metadataDirectory": "release/metadata/en-US",
"screenshots": "release/screenshots.json"
"screenshots": "release/screenshots.json",
"versionNotes": "release/notes/1.0.0.md"
}
17 changes: 14 additions & 3 deletions apps/mobile/release/metadata/en-US/description.txt
Original file line number Diff line number Diff line change
@@ -1,7 +1,18 @@
DRAFT, NOT APPROVED FOR UPLOAD

Proposed first-release copy, contingent on native implementation and device qualification:
A little time for dice.

Play a local dice game on iPhone or iPad. Roll, hold dice and choose a scoring combination. Play solo or against up to three computer opponents. The proposed release keeps games and scores on your device and works offline.
Third Roll is a house-rule dice game for iPhone and iPad. Pick five, six, eight or ten dice, then play solo or against up to three computer opponents.

Replace this draft only after resume behavior and device qualification are confirmed. The name, modes and house rules are decided in #39. Do not claim remote multiplayer, cloud leaderboards, licensed affiliation or unqualified accessibility support.
Each turn begins with a roll. Hold the dice you want and reroll the others up to twice. Choose an unused category to record your hand, build your upper-section total and chase the next bonus.

These house rules include pairs and larger-hand combinations. Full Straight scores 50. Castle needs two distinct triples. All of a Kind needs the whole hand to match. Read the full rules in Help.

Games and completed scores stay on your device. Continue a saved game, browse local history and compare your high scores for each dice count. Local scores are personal records, not global rankings. Gameplay works offline without an account.

Choose System, Light or Dark appearance. Help includes save-recovery guidance and an optional diagnostic preview that you can review before choosing to share.

There are no remote players, cloud scoreboards, ads, purchases or subscriptions in this edition. System backups can include app data according to your device settings. Resetting local data does not remove old backups.

Support: https://hemsoft-dev.github.io/yahtzee/support.html
Privacy: https://hemsoft-dev.github.io/yahtzee/privacy.html
41 changes: 28 additions & 13 deletions apps/mobile/release/metadata/en-US/listing.json
Original file line number Diff line number Diff line change
@@ -1,21 +1,36 @@
{
"status": "draft",
"sourceReviews": {
"description": { "status": "draft", "sha256": null },
"reviewNotes": { "status": "draft", "sha256": null },
"releaseNotes": { "status": "draft", "sha256": null },
"testNotes": { "status": "draft", "sha256": null }
"description": {
"status": "draft",
"sha256": null
},
"reviewNotes": {
"status": "draft",
"sha256": null
},
"releaseNotes": {
"status": "draft",
"sha256": null
},
"testNotes": {
"status": "draft",
"sha256": null
}
},
"name": "Third Roll",
"subtitle": null,
"promotionalText": null,
"keywords": null,
"copyright": null,
"supportUrl": null,
"marketingUrl": null,
"privacyUrl": null,
"subtitle": "Offline dice, house rules",
"promotionalText": "Choose five, six, eight or ten dice. Hold, reroll and fill a house-rule scorecard, solo or against computer opponents.",
"keywords": "dice,offline,scorecard,solo,computer,combinations,pairs,straights",
"copyright": "2026 Franz Hemmer / HemSoft Developments",
"supportUrl": "https://hemsoft-dev.github.io/yahtzee/support.html",
"marketingUrl": "https://hemsoft-dev.github.io/yahtzee/",
"privacyUrl": "https://hemsoft-dev.github.io/yahtzee/privacy.html",
"accessibilityUrl": null,
"primaryCategory": null,
"primaryCategory": "Games",
"secondaryCategory": null,
"notes": "Approved contact details, commercial/legal decisions and tested claims are required. Null is deliberately incomplete, not an upload value."
"notes": "Prepared English-only launch copy under delegated product authority. Status and source reviews remain draft pending signed-device acceptance, final screenshots, copyright/contact/legal confirmation and App Store Connect preview. Support URL is live but GitHub-only contact does not yet satisfy Apple contact-information requirements. No upload, sync or submission in this session.",
"gameSubcategories": [
"Board"
]
}
2 changes: 1 addition & 1 deletion apps/mobile/release/metadata/en-US/release_notes.txt
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
DRAFT, NOT APPROVED FOR UPLOAD

First iOS release, pending implementation, qualification and approval. Do not publish this placeholder. For the first submission, omit What's New if App Store Connect does not expose it. Later versions summarize only the user-visible changes in the corresponding dated iOS changelog entry.
First release of Third Roll for iPhone and iPad. Play house-rule games with five, six, eight or ten dice, solo or against up to three computer opponents. Continue saved games and view scores on your device.
Comment thread
Copilot marked this conversation as resolved.
Resolved
21 changes: 11 additions & 10 deletions apps/mobile/release/metadata/en-US/review_notes.txt
Original file line number Diff line number Diff line change
@@ -1,14 +1,15 @@
DRAFT, NOT APPROVED FOR SUBMISSION
DRAFT, NOT APPROVED FOR UPLOAD

The repository's separate native implementation runs locally without an account or required Convex connection. It offers five, six, eight and ten dice with one human and zero to three computer opponents. These development choices and the public identity still need owner approval. Unsigned simulator results do not establish the signed candidate's behavior.
Prepared reviewer notes. Do not upload until verified against the signed candidate and final public contact information.

After signed-device qualification, verify these steps against the exact candidate before supplying reviewer-facing notes:
1. Launch, enter a display name, choose a dice count and computer-opponent count, then start. The first roll is automatic.
2. Tap a die to hold it, reroll the other dice and select a score category. Castle requires two distinct triples; the larger all-dice category requires the whole hand to match.
3. Pause and resume the acknowledged active game. Cold-launch resume, local results and rankings are on-device only, not an online leaderboard.
4. Open Help for house rules and optional diagnostics. Previewing or cancelling sends nothing; choosing Share opens the operating system's share controls with the previewed allowlist text.
5. Test reset only with disposable data and explicit confirmation. Damaged saves remain untouched until an explicit recovery/reset choice.
Third Roll uses original branding and house rules. No licensed affiliation is claimed. There is no account or sign-in, no remote multiplayer, no purchases and no required game-server connection. No demo credentials are needed.

Record actual signed-device results, supported modes, approved support/privacy URLs and any changed behavior in the release tracker. Do not claim zero network traffic, completed VoiceOver/backup testing or accepted privacy/export declarations from simulator evidence alone.
1. Launch, enter a display name, choose five, six, eight or ten dice and zero to three computer opponents. Start Game performs the first roll automatically.
2. Tap dice to hold them, reroll the others up to twice and choose an unused scoring row. Full Straight is 50 points; Castle needs distinct triples; All of a Kind requires the entire hand to match.
3. Pause and resume a saved game. Scores and history are local, separated by dice mode. They are not online rankings.
4. Open Help for rules, build/version and optional diagnostic preview. Cancelling sends nothing; explicit sharing opens the OS sheet with the previewed allowlist text.
5. Test deletion only with disposable data and explicit confirmation. Save recovery preserves damaged data until an explicit choice.

Enter review contact information privately in App Store Connect. Do not commit contact phone numbers, credentials, tester details or private review correspondence here.
Release staff must recheck these paths on the exact signed iPhone/iPad candidate. Source and unsigned simulator qualification do not supply physical-device, VoiceOver, backup/restore, SDK traffic or export acceptance. In-app website destinations are tracked in issue #44 and must match the public URLs before submission.

The support page currently offers GitHub reporting only. Provide approved public contact information before upload, in line with Apple's current support-URL requirements. Enter review contact fields privately in App Store Connect during a separately authorized session. Do not commit phone numbers, credentials, tester identities or private correspondence.
Loading
Loading