feat(i18n): add complete English and Chinese localization

Completes T23 trilingual application/content localization with deterministic language persistence, localized notifications and accessibility copy, multilingual catalog search, and language-invariant domain ordering.

Pull-request CI: https://github.com/DrEden33773/FreshLoop/actions/runs/30094147720

Author: MIAO-mia

.github/workflows/ci.yml

@@ -66,3 +66,93 @@ jobs:
 
       - name: Test
         run: npm run test:ci
+
+      - name: Export Android bundle
+        run: npm run export:android
+
+      - name: Export iOS bundle
+        run: npm run export:ios
+
+  android-release:
+    name: Android single-ABI release build
+    if: github.event_name != 'pull_request'
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v7
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v7
+        with:
+          node-version: 24.14.0
+          cache: npm
+          cache-dependency-path: mobile/package-lock.json
+
+      - name: Set up Java
+        uses: actions/setup-java@v5
+        with:
+          distribution: temurin
+          java-version: "21"
+
+      - name: Set up Gradle cache
+        uses: gradle/actions/setup-gradle@v5
+
+      - name: Install dependencies and build release APK
+        working-directory: mobile
+        run: |
+          npm ci
+          npx expo prebuild --platform android --clean
+          cd android
+          ./gradlew app:assembleRelease -PreactNativeArchitectures=x86_64
+
+      - name: Upload release APK
+        uses: actions/upload-artifact@v6
+        with:
+          name: android-release-x86_64
+          path: mobile/android/app/build/outputs/apk/release/app-release.apk
+          if-no-files-found: error
+
+  android-i18n:
+    name: Android trilingual critical journeys (manual)
+    if: github.event_name == 'workflow_dispatch'
+    needs: android-release
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v7
+
+      - name: Download release APK
+        uses: actions/download-artifact@v8
+        with:
+          name: android-release-x86_64
+          path: mobile/android/app/build/outputs/apk/release
+
+      - name: Install Maestro
+        run: curl -Ls https://get.maestro.mobile.dev | bash
+
+      - name: Run English and Chinese Android journeys
+        uses: reactivecircus/android-emulator-runner@v2
+        with:
+          api-level: 36
+          arch: x86_64
+          profile: pixel_6
+          disable-animations: true
+          script: |
+            adb install -r mobile/android/app/build/outputs/apk/release/app-release.apk
+            "$HOME/.maestro/bin/maestro" test mobile/.maestro/i18n-en.yaml
+            "$HOME/.maestro/bin/maestro" test mobile/.maestro/i18n-zh-CN.yaml
+            adb shell wm size 320x720
+            adb shell settings put system font_scale 2.0
+            "$HOME/.maestro/bin/maestro" test mobile/.maestro/i18n-zh-TW.yaml
+
+      - name: Upload Android localization results
+        if: always()
+        uses: actions/upload-artifact@v6
+        with:
+          name: android-i18n-results
+          path: mobile/dist/maestro-results
+          if-no-files-found: warn

README.md

@@ -2,6 +2,8 @@
 
 FreshLoop is a local-first Expo 57 / React Native pantry application for Android-first classroom demonstration. It keeps inventory in on-device SQLite, distinguishes `Use By` safety wording from `Best Before` quality wording, ranks items with an explanation, offers a small local Rescue recipe catalogue, and records only user-confirmed outcomes.
 
+The complete app and bundled ingredient/recipe content are available in English, Simplified Chinese, and Traditional Chinese. Change language in **Settings → Language**; the choice applies immediately, survives restart, and overrides the device language. User-entered names/notes and Open Food Facts product names remain exactly as supplied, while search matches all three bundled catalog languages.
+
 ## Prerequisites
 
 - Windows 10/11 with hardware virtualization enabled, or Ubuntu 24.04 under WSL 2 with a Windows Android emulator.
@@ -92,7 +94,7 @@ node --test tools/freshloop/__tests__/*.test.cjs
 
 A clean-extraction acceptance is not complete until the native command has also auto-started an emulator, built and installed the APK, brought `com.comp7506d.freshloop/.MainActivity` to the foreground, and reached the Metro phase. JavaScript exports alone do not validate the README native path.
 
-The Android critical journeys are in `mobile/.maestro/` and can be run against an installed APK with `maestro test .maestro`. The current release candidate passed 54 Jest suites / 132 tests, Android and iOS production exports, a Gradle release build, and API 36 navigation checks. iOS was export-tested only; no iOS device or simulator result is claimed.
+The Android critical journeys are in `mobile/.maestro/` and can be run against an installed APK with `maestro test .maestro`. The current integration branch passes 57 Jest suites / 156 tests; production exports, the Gradle release build, and the three-language Android journeys are revalidated in T23/F1-F4 before the release-candidate statement is refreshed. iOS remains export-only; no iOS device or simulator result is claimed.
 
 ## Classroom demo and reset
 
@@ -132,6 +134,7 @@ Important source areas:
 - Manual entry, Today, Rescue, outcomes, and Insights work without network access after installation.
 - Barcode lookup is optional. When used online, the scanned barcode is sent to the public Open Food Facts API to suggest a product name. The user must confirm the physical package; FreshLoop never imports expiry dates or makes a safety decision from Open Food Facts.
 - Reminder settings use OS-local notifications and can be denied or disabled without blocking the pantry.
+- Reminder payloads record the selected locale. On startup or language change, managed reminders created in another language are replaced without changing the SQLite schema.
 - Open Food Facts data is crowdsourced and licensed under ODbL; see [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) for dependency, font, asset, and data-source notices.
 
 ## Verified platform boundary
@@ -163,6 +166,7 @@ Important source areas:
 - Refreshed 60fps video/submission evidence: `qa/evidence/T22-video-refresh/`
 - Windows one-command toolchain evidence: `qa/evidence/T19-windows-toolchain/`
 - WSL/Windows emulator bridge evidence: `qa/evidence/T20-wsl-android/`
+- Three-language localization evidence: `qa/evidence/T23-i18n/`
 
 Generated APKs, source archives, final rendered videos, and the supplied course brief are intentionally excluded from Git history. Build distributable copies with the documented release scripts and publish them through the approved course delivery channel or a suitable release store.
 

docs/contributions.md

@@ -7,6 +7,8 @@ This ledger records only identities and work visible in repository evidence. It
 | Member / repository identity | Actual task | Evidence | Verification |
 |---|---|---|---|
 | `DrEden33773` | Initialized the Expo project; authored governance/design; implemented date, lifecycle, recipe, SQLite, onboarding, Pantry, Today, Insights, Rescue, barcode, reminder, accessibility, and release-hardening slices through T16. | Git commits `3b6af8a` through `bedca05`; source under `mobile/`; task receipts under `qa/evidence/T01-toolchain/` through `qa/evidence/T16-android-qa/`. | Git history identifies the same author for the commits; automated gates and real Android emulator receipts are summarized in `qa/evidence/T16-android-qa/result.txt`. |
+| `mmy0302` | Introduced the initial English/Simplified Chinese/Traditional Chinese resources, language selector, and first translated feature surfaces that became the base of T23. | Branch commits `b404541`, `ec8b311`, and `13b1889`; initial implementation under `mobile/src/i18n/` and translated feature files. | T23 completion tests validate the retained implementation after persistence, content, notification, accessibility, and full-surface hardening. |
+| `DrEden33773` | Completed T23 integration hardening: deterministic language restoration, full surface/content localization, stable validation codes, locale-aware notification replacement, typed catalogs, three-language tests/Android CI, and documentation alignment. | T23 commit on `feat/i18n-v2-zh`; `mobile/src/i18n/`, localized feature/content/notification files, `.github/workflows/ci.yml`, and `qa/evidence/T23-i18n/`. | Local typecheck, lint, 57 Jest suites / 156 tests, and Android/iOS exports pass; the required three-language Android CI result remains a pre-merge gate. |
 
 ## External reconciliation still required
 

docs/demo-script.md

@@ -32,5 +32,5 @@
 
 - Do not say that FreshLoop determines food safety, prevents food waste, or measures savings.
 - Do not describe Open Food Facts as complete or authoritative.
-- Do not claim full Traditional Chinese localisation or iOS device verification.
+- Do not claim that the three-language Android surface matrix has passed until T23 evidence is complete; never claim iOS device verification.
 - Do not show development-only notification diagnostics in a release demonstration.

docs/design-system.md

@@ -1,6 +1,6 @@
 # FreshLoop mobile design system
 
-Status: frozen T03 implementation contract for the Android-first app and its introduction video. English is the primary UI language; Traditional Chinese aliases support recognition and future localization. There is no dark mode or tablet-specific visual branch in this release.
+Status: T03 visual contract plus the approved T23 localization extension for the Android-first app and its introduction video. English, Simplified Chinese, and Traditional Chinese are complete product languages. There is no dark mode or tablet-specific visual branch in this release.
 
 ## 0. Research log
 
@@ -178,4 +178,3 @@ Accepted design debt: none in T03. Real Android primitive/screen QA, keyboard/sc
 ## 9. Handoff and change control
 
 T08 must map every implementation color, type, spacing, radius, elevation, icon, and motion value to this document. A new semantic role is added here before code uses it. T22 keeps the film at exactly 90 seconds / 5400 frames at 60fps and every app visual remains a named real Android recording. Any new font, icon, music, voice, image, or footage enters `docs/asset-manifest.md` with owner, license, and provenance before use.
-

docs/project/decision-record.md

@@ -24,7 +24,7 @@
 | --- | --- | --- |
 | Repository shape | Separate mobile and video packages | Avoid Expo monorepo complexity |
 | Recipe content | Exactly 12 original recipes and at least 30 normalized ingredients | Sufficient demo variety within the deadline |
-| Language | English UI with Traditional Chinese ingredient aliases | Local relevance without full i18n scope |
+| Language | Complete English, Simplified Chinese and Traditional Chinese UI/content | Approved T23 scope expansion; saved choice overrides device locale |
 | Video | 90 seconds, 1920x1080, 60 fps | Inside the required one-to-two-minute range; smoother app footage |
 | Android top-level navigation | Five Expo Router Native Tabs | Native safe-area handling; Settings is discoverable from every tab |
 | Expiry card copy | `USE BY / THURSDAY` | `THU` meant Thursday, not a university; spelling it out removes ambiguity |
@@ -47,15 +47,15 @@
 - Food dates use the Asia/Hong_Kong local calendar. Past Use By items are excluded from Rescue; Best Before never becomes a safety verdict.
 - Domain rules, migrations and notification policy use TDD. UI behavior is covered by component tests and real Android QA.
 - Android is fully verified. iOS receives static/export coverage only and must not be called device-tested.
-- The visual direction is warm editorial pantry; English UI includes Chinese ingredient aliases without full bilingual i18n.
+- The visual direction is warm editorial pantry; T23 localizes the complete product and bundled content in English, Simplified Chinese and Traditional Chinese without translating user/OFF free text.
 - Report and video claims are source-backed, and video app visuals come only from the real Android build.
 - Android edge-to-edge navigation uses native tabs and explicitly validates gesture/three-button modes at 320dp and 200% text.
 - Video captions use 40px Manrope in one/two compact lower-left boxes; sequence timing is expressed in seconds and converted through the 60fps contract.
 
 ## Scope boundaries
 
 - Included: seven core surfaces, lightweight onboarding and Settings/About, food CRUD, five date bases, local notifications, twelve recipes, outcomes, Insights, optional product lookup, deterministic demo data, Android APK/evidence, report, demo kit, video and clean submission package.
-- Excluded: authentication, cloud sync, sharing, social/chat/payment, shopping collaboration, AI, OCR, expiry prediction, medical or safety diagnosis, quantified environmental savings, partial quantities, item photos, dark mode, tablet specialization, full Chinese UI, app-store release and iOS device verification claims.
+- Excluded: authentication, cloud sync, sharing, social/chat/payment, shopping collaboration, AI, OCR, expiry prediction, medical or safety diagnosis, quantified environmental savings, partial quantities, item photos, dark mode, tablet specialization, network translation, app-store release and iOS device verification claims.
 
 ## Review and approval history
 
@@ -64,6 +64,7 @@
 - 2026-07-15: the user approved the recommended defaults and authorized implementation.
 - 2026-07-16: T01-T15 are recorded complete in the work plan. T16 is the next permitted implementation stage.
 - 2026-07-21: T21/T22 adopt native five-tab navigation, `THURSDAY`, compact lower-left captions, shared cross-platform recording actions, and a 60fps/5400-frame final render while preserving T18 as historical evidence.
+- 2026-07-24: the user explicitly approved T23 complete trilingual localization and T24 contract-tested macOS Android tooling as the only post-freeze scope expansions. Android remains the only fully device-verified platform; hosted Mac CI is not device/emulator proof.
 - 2026-07-21: after reviewing publication risk, the user required the original course brief and MP4 delivery assets to remain Git-ignored. The course brief is listed in `.worktreeinclude` so Codex-managed worktrees can use the local file without publishing it.
 
 ## Open questions