Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .github/workflows/quality.yml
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,11 @@ jobs:
- name: Lint
if: ${{ !cancelled() && steps.install.outcome == 'success' }}
run: bun run lint
- name: iOS release-record consistency tests and draft check
if: ${{ !cancelled() && steps.install.outcome == 'success' }}
run: |
node --test scripts/ios-release/*.test.mjs
node scripts/ios-release/check.mjs
- name: Unit and backend tests
if: ${{ !cancelled() && steps.install.outcome == 'success' }}
run: bun run test
Expand Down
2 changes: 2 additions & 0 deletions apps/mobile/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
# Editable release records are source, unlike generated desktop release output.
!/release/
81 changes: 81 additions & 0 deletions apps/mobile/APP-STORE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,81 @@
# iOS release tracker

Status: preparation only. No approved public name, signed candidate, App Store record, TestFlight acceptance or public release is recorded here. The current native app still uses Convex. A JavaScript export does not prove an offline iOS release.

Parent: [#38](https://github.com/HemSoft/yahtzee/issues/38). Release records: [#47](https://github.com/HemSoft/yahtzee/issues/47).

## Ownership and authority

The repository maintainer owns implementation, repeatable checks and evidence collection. The owner must approve public identity and rights, contact publication, price/territories, legal declarations, spending, external tester invitations, App Review submission and publication. A green script does not supply those approvals. Keep credentials, private contact information, identity documents and signing keys out of GitHub.

## Proposed scope, not a legal approval

Use the existing Expo/React Native app and shared TypeScript engine. The reversible engineering baseline is one local human, zero to three AI opponents, mobile presets of five/six/eight/ten dice and English. Preserve the current Castle rule of two distinct triples and the all-dice-matching rule in larger games. Do not invent a dedicated six-of-a-kind category or treat these choices as an owner-approved public rules contract.

Proposed v1 excludes accounts, remote multiplayer, cloud scores/sync, analytics, ads, purchases, subscriptions, Game Center, widgets and Watch. Device/orientation/minimum-OS details require native qualification. Keep the current development identifier private to development; do not reserve or publish an App Store identity under it.

The release scope and rights decision remains [#39](https://github.com/HemSoft/yahtzee/issues/39). Existing repository branding and its MIT license are not trademark clearance.

## 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).

From the repository root:

```sh
node --test scripts/ios-release/*.test.mjs
node scripts/ios-release/check.mjs
```

Draft mode validates the record and source-file structure, prints every remaining release blocker, and never uploads anything. `consistent: false` is expected now. It is not a release pass.

For a real candidate, configure the accepted native version/build first. Compare the proposed build number against the latest App Store Connect build and every prior local archive; increment it and never reuse an uploaded number. Commit the approved source and metadata. Copy the record to an ignored `reports/ios-candidate.json` and fill its exact source SHA and artifact/evidence references there. Do not try to embed a commit's own SHA inside itself.

```sh
node scripts/ios-release/check.mjs --release \
--record reports/ios-candidate.json --archive reports/accepted.ipa \
--screenshots reports/ios-captures/manifest.json
```

The release check fails on an incomplete record, dirty source, mismatched native identity/version/build, wrong source SHA or archive checksum, draft copy, absent listing fields or screenshot provenance mismatch. All referenced copy and planning files must be tracked and match HEAD after CRLF/LF normalization, so clean Windows checkouts remain valid. Ignored, absolute and untracked source paths are rejected.

The tracked screenshot JSON is a scene plan, not a capture receipt. Generate the accepted capture manifest beside the images after freezing the source commit, then store its SHA-256 in the external candidate record. Give it status `accepted`, matching sourceCommit/version/buildNumber, and a nonempty captures array. Each capture needs filename relative to that artifact folder, sourceCommit, deviceFamily `iphone` or `ipad`, locale, appearance `light` or `dark`, pixel width/height, and SHA-256. The checker verifies each file's PNG signature, dimensions and hash; capture paths and symlinks cannot escape that folder. This does not replace visual review or Apple's current device-size requirements. Set listing status to `approved` only after the owner approves the copy. Each `sourceReviews` role also needs `approved` and the SHA-256 of its accepted UTF-8 text with LF line endings. Any later text change invalidates that receipt. Remove draft instructions and placeholders from accepted test and store notes. These recorded statuses do not grant legal authority; the maintainer must verify the owner's evidence separately. This is a consistency guard, not a signing validator or proof that cited owner/device evidence is genuine. Review those receipts separately. If dynamic Expo configuration replaces app.json, update the checker to consume the resolved configuration before using it for release.

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.

## 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.

## Release checklist and evidence

Leave a checkbox open until its linked receipt proves the exact candidate.

| Gate | Owner | Evidence and prerequisite |
| --- | --- | --- |
| Public identity, rights, scope, commerce | Owner | [#39](https://github.com/HemSoft/yahtzee/issues/39), not approved |
| Shared baseline and native configuration | Maintainer | [#40](https://github.com/HemSoft/yahtzee/issues/40), baseline PR under review |
| Offline saves, recovery and resume | Maintainer | [#41](https://github.com/HemSoft/yahtzee/issues/41), real-device evidence required |
| Native UI and accessibility | Maintainer and device tester | [#42](https://github.com/HemSoft/yahtzee/issues/42) |
| Team/app record, price, territories, EULA, trader status, age rating | Owner | [#43](https://github.com/HemSoft/yahtzee/issues/43), App Store state not verified |
| Rules, support, privacy, reset and review paths | Maintainer | [#44](https://github.com/HemSoft/yahtzee/issues/44) |
| Original licensed icon/launch assets | Maintainer and owner | [#45](https://github.com/HemSoft/yahtzee/issues/45) |
| Native CI, archive, signing, checksum | Maintainer and signing owner | [#46](https://github.com/HemSoft/yahtzee/issues/46) |
| Data flows, native manifests, privacy/export declarations | Maintainer and owner | [#48](https://github.com/HemSoft/yahtzee/issues/48) |
| Public marketing/support/privacy URLs | Maintainer and owner | [#49](https://github.com/HemSoft/yahtzee/issues/49) |
| Listing fields, claims and previews | Maintainer and owner | [#50](https://github.com/HemSoft/yahtzee/issues/50) |
| Ordered native screenshots | Maintainer | [#51](https://github.com/HemSoft/yahtzee/issues/51) |
| Signed TestFlight acceptance | Device tester and owner | [#52](https://github.com/HemSoft/yahtzee/issues/52) |
| Submission approval, review correspondence and Apple approval | Owner | [#53](https://github.com/HemSoft/yahtzee/issues/53) |
| Publication, store-installed smoke, source tag and support check | Owner and maintainer | [#54](https://github.com/HemSoft/yahtzee/issues/54) |

- [ ] Record accepted app ID, bundle ID, version/build, source commit, archive hash and private receipt locations.
- [ ] Confirm all implementation and native QA gates, including offline restart and save recovery on iPhone and iPad.
- [ ] Recheck [Apple upload requirements](https://developer.apple.com/news/upcoming-requirements/) and [submission requirements](https://developer.apple.com/app-store/submitting/).
- [ ] Review current privacy/export/age/content-rights answers and owner approvals against the actual archive.
- [ ] Verify public URLs, localized copy, screenshots and required App Store Connect fields without placeholders.
- [ ] Get explicit TestFlight upload/invitation and App Review submission approval. Record sanitized IDs/status separately.
- [ ] Default to manual first release; obtain explicit publication approval after Apple approval.
- [ ] Verify the live listing and store-installed app, publish the dated iOS changelog/tag, and assign post-release support.

No checkbox is complete merely because this document exists. Update this tracker when each gate changes; record dates in Eastern Time.
15 changes: 15 additions & 0 deletions apps/mobile/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# iOS changelog

No iOS version has shipped. Windows and web changes have their own release history.

## Unreleased

### Added

- Draft release records, editable listing sources and a fail-closed candidate check. Tracked in [#47](https://github.com/HemSoft/yahtzee/issues/47).

## Release entry format

After public-store verification, move the applicable Unreleased entries under `## 1.0.0 - YYYY-MM-DD`, using the release date in Eastern Time. Include the exact iOS build, source commit, source tag and public listing link. Link implementation PRs; do not list planned features as shipped.

Later entries use Added, Changed and Fixed only when applicable. App Store What's New text is a short summary of that release's user-visible changes. The first submission may not expose this updates-only field. Never invent a prior release or a release date to fill it.
20 changes: 20 additions & 0 deletions apps/mobile/release/candidate.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
{
"schemaVersion": 1,
"status": "draft",
"version": "1.0.0",
"buildNumber": "1",
"sourceCommit": null,
"tag": "ios/v1.0.0",
"appStoreVersion": "1.0.0",
"appStoreId": null,
"bundleIdentifier": null,
"archiveSha256": null,
"screenshotManifestSha256": null,
"testFlightBuildId": null,
"ownerApprovalEvidence": null,
"nativeQualificationEvidence": null,
"changelog": "CHANGELOG.md",
"testNotes": "release/testflight-notes.md",
"metadataDirectory": "release/metadata/en-US",
"screenshots": "release/screenshots.json"
}
7 changes: 7 additions & 0 deletions apps/mobile/release/metadata/en-US/description.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
DRAFT, NOT APPROVED FOR UPLOAD

Proposed first-release copy, contingent on native implementation and device qualification:

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.

Replace this draft only after the supported modes, house rules, resume behavior, original public name and rights are approved. Do not claim remote multiplayer, cloud leaderboards, licensed affiliation or unqualified accessibility support.
21 changes: 21 additions & 0 deletions apps/mobile/release/metadata/en-US/listing.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
{
"status": "draft",
"sourceReviews": {
"description": { "status": "draft", "sha256": null },
"reviewNotes": { "status": "draft", "sha256": null },
"releaseNotes": { "status": "draft", "sha256": null },
"testNotes": { "status": "draft", "sha256": null }
},
"name": null,
"subtitle": null,
"promotionalText": null,
"keywords": null,
"copyright": null,
"supportUrl": null,
"marketingUrl": null,
"privacyUrl": null,
"accessibilityUrl": null,
"primaryCategory": null,
"secondaryCategory": null,
"notes": "Owner-approved identity, contact details, commercial/legal decisions and tested claims are required. Null is deliberately incomplete, not an upload value."
}
3 changes: 3 additions & 0 deletions apps/mobile/release/metadata/en-US/release_notes.txt
Original file line number Diff line number Diff line change
@@ -0,0 +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.
5 changes: 5 additions & 0 deletions apps/mobile/release/metadata/en-US/review_notes.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
DRAFT, NOT APPROVED FOR SUBMISSION

After native qualification, describe the actual offline access, account requirements, dice modes, house rules, computer opponents, persistence, reset and support paths. Provide numbered steps through the shipping app, not a fixture mode or developer server. Do not claim that Convex has been removed until the native release proves it.

Enter review contact information privately in App Store Connect. Do not commit contact phone numbers, credentials, tester details or private review correspondence here.
11 changes: 11 additions & 0 deletions apps/mobile/release/screenshots.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
{
"status": "not-captured",
"sourceCommit": null,
"version": "1.0.0",
"buildNumber": "1",
"locales": ["en-US"],
"scenes": ["setup", "hold-dice", "score-combination", "bonus-progress", "results", "history"],
"captures": [],
"appPreview": "deferred",
"note": "No approved native captures yet. Record device family, pixel dimensions, appearance, locale, filename, SHA-256 and source commit for each accepted capture. Verify Apple's current listing requirements before capture or upload."
}
11 changes: 11 additions & 0 deletions apps/mobile/release/testflight-notes.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
# Proposed 1.0 testing notes

Draft only. No signed candidate has been accepted or uploaded.

Before inviting testers, bind these notes to the exact source commit, version, build and TestFlight build ID in candidate.json. Confirm the shipped app's behavior before replacing this draft with tester-facing copy.

Test offline cold launch, all approved dice modes, solo and three AI opponents, hold/reroll/score, bonus thresholds, results, duplicate-save prevention, backgrounding, force termination and explicit resume/discard. Exercise corrupt and interrupted storage recovery, an upgrade from the previous beta, support previews and reset confirmation.

Record iPhone and iPad models/OS versions without device identifiers or tester email addresses. Include VoiceOver, large text, Reduce Motion, safe areas, allowed rotation and iPad resizing. Link sanitized results in the release tracker. A JavaScript export or mobile web adapter is not native device evidence.

External invitations require owner approval. Uploading a build does not submit it for App Review or publish it.
5 changes: 4 additions & 1 deletion bun.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

1 change: 1 addition & 0 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -55,6 +55,7 @@
"mutation-testing-metrics": "3.8.4",
"mutation-testing-report-schema": "3.9.0",
"playwright": "1.63.0",
"pngjs": "7.0.0",
"react": "19.2.3",
"react-dom": "19.2.3",
"react-native-web": "0.21.2",
Expand Down
Loading
Loading