NKO-5.1: TestFlight Build — ߒߞߏ Bridge

NKO-5.1: TestFlight Build — ߒߞߏ Bridge

Status: ✅ ARCHIVE SUCCEEDED — Ready for TestFlight upload
Completed: 2026-02-19T18:44:00-05:00

---

Build Summary

---

What Was Done

### 1. Xcode Project Verification & Repair
- Found existing `NKoBridge.xcodeproj` at `Desktop/NKo/ios/` with only the app target
- Keyboard extension (`NKoKeyboardExtension/`) existed as source but was NOT wired into the project
- Regenerated project using XcodeGen with updated `project.yml` containing both targets:
- `NKoBridge` (application) — depends on NKoTransliteration, NKoPhonetics, NKoCulture packages
- `NKoKeyboardExtension` (app-extension) — depends on NKoKeyboardEngine package
- All SPM packages resolve from root `Desktop/NKo/Package.swift` (NKoCore monorepo)

### 2. Build Fixes Applied
- Fixed compilation error in `KeyboardViewController.swift:588` — replaced convoluted `allSatisfy` closure with clean tone mark range check `(0x07EB...0x07F3)`
- Fixed version mismatch — keyboard extension `CFBundleShortVersionString` changed from `1.0` to `1.0.0` to match containing app

3. Release Archive Created

Archive: Desktop/NKo/ios/build/NKoBridge.xcarchive
IPA:     Desktop/NKo/ios/build/dev-export/NKoBridge.ipa

### 4. Archive Contents Verified
- ✅ `NKoBridge` binary (1.8MB arm64)
- ✅ `NKoKeyboardExtension.appex` embedded in `PlugIns/`
- ✅ App icon (1024x1024 universal + device-specific variants)
- ✅ Cultural resources bundled: proverbs, blessings, calendar, clans, greetings, concepts (6 JSON files)
- ✅ Phonetics data (`nko-unified.json`) in both app and extension
- ✅ dSYMs for both targets (crash symbolication ready)
- ✅ Code signed (development profile)
- ✅ Provisioning profiles embedded

---

What Needs Manual Steps (Mo)

### Step 1: Create App Store Connect Record
The export for App Store failed because no app record exists yet:

error: exportArchive Error Downloading App Information

Action needed:
1. Go to [App Store Connect](https://appstoreconnect.apple.com)
2. Click My Apps → + → New App
3. Fill in:
- Platform: iOS
- Name: N'Ko Bridge (or ߒߞߏ Bridge)
- Primary Language: English
- Bundle ID: `com.openclaw.nko-bridge`
- SKU: `nko-bridge-001`
4. Save

### Step 2: Upload to TestFlight
After creating the app record, from this Mac:

Option A — Xcode Organizer (easiest):
1. Open Xcode → Window → Organizer
2. Select the `NKoBridge` archive (dated Feb 19, 2026)
3. Click Distribute App → App Store Connect → Upload
4. Follow prompts (automatic signing should work — distribution cert is on this machine)

Option B — Command line:

cd Desktop/NKo/ios
xcodebuild -exportArchive \
  -archivePath build/NKoBridge.xcarchive \
  -exportPath build/appstore-export \
  -exportOptionsPlist build/ExportOptions.plist \
  -allowProvisioningUpdates

Option C — altool/xcrun:

xcrun altool --upload-app -f build/dev-export/NKoBridge.ipa \
  -t ios --apiKey <KEY_ID> --apiIssuer <ISSUER_ID>

### Step 3: TestFlight Configuration
After upload processes (5-30 min):
1. Go to App Store Connect → TestFlight
2. Add test information:
- Beta App Description: "N'Ko Bridge — Cross-script transliteration and cultural tools for the N'Ko writing system"
- Beta App Review Information: Demo account not required
- Contact: Your email
3. Add testers (internal or external group)
4. Submit for Beta App Review (external) or enable directly (internal)

---

App Store Submission Checklist

Required Before App Store Review

Suggested App Store Description

N'Ko Bridge — ߒ߬ߞߏ ߛߊ߬ߙߊ

The first iOS app for real-time cross-script transliteration between N'Ko (ߒߞߏ), Latin, and Arabic scripts.

BRIDGE
• Type in any script — see all three simultaneously
• Automatic script detection
• IPA phonetic transcription
• Voice input (speak Manding, see N'Ko)
• Copy & share transliterations

KEYBOARD
• Full N'Ko keyboard with standard typewriter layout
• Latin→N'Ko transliteration mode
• Arabic script mode
• Predictive text with 3 ranked suggestions
• All 9 N'Ko tone marks (U+07EB–U+07F3)
• Haptic feedback & RTL support

CULTURE
• 50+ Manding proverbs with translations
• Traditional blessings for every occasion
• Cultural calendar with important dates
• Clan explorer with sigils and histories
• Greetings browser

ACCESSIBILITY
• Full VoiceOver support
• Dynamic Type throughout
• Right-to-left layout
• Dark mode support

Built with love for the N'Ko writing system — created by Souleymane Kanté in 1949 to write Manding languages.

Suggested Keywords

nko,n'ko,manding,bambara,transliteration,keyboard,african,script,culture,proverbs

### Privacy Policy Requirements
The app requests:
- Microphone — for voice-to-N'Ko transliteration
- Speech Recognition — for spoken Manding to text conversion

A privacy policy must be hosted at a public URL. It should cover:
- What data is collected (speech audio — processed on-device, not transmitted)
- No user accounts or personal data collection
- No analytics or tracking
- Keyboard extension data handling (with Open Access explanation)

---

File Locations

---

Signing Certificates on This Machine

Both certificates are valid. Distribution cert is what's needed for App Store/TestFlight uploads.

---

Build Warnings (Non-blocking)

1. `traitCollectionDidChange` deprecated in iOS 17.0 — use trait change registration APIs (KeyboardViewController.swift)
2. Unused `buffer` initialization (SigilsPlayerView.swift)
3. `AVAudioSession.recordPermission` deprecated — use `AVAudioApplication.recordPermission` (SpeechRecognizer.swift, 5 instances)
4. Nil coalescing with non-optional left side (VoiceTransliterator.swift)

These are all cosmetic and will not prevent App Store review.

---

TL;DR — What Mo Needs to Do

1. Create app in App Store Connect (bundle ID: `com.openclaw.nko-bridge`)
2. Open Xcode Organizer → select archive → Distribute App → App Store Connect
3. Wait for processing (5-30 min)
4. Add testers in TestFlight tab
5. (For App Store release later) Take screenshots, write privacy policy, fill metadata