docs: add EAS builds section to d-sports-engage-native

repositories/d-sports-engage-native.mdx

@@ -1,12 +1,12 @@
 ---
 title: "d-sports-engage-native"
 description: "Native iOS and Android app for D-Sports Engage. Expo 54, React Native, Clerk, RevenueCat, Thirdweb."
 icon: "smartphone"
 ---
 
 ## Overview
 
 **d-sports-engage-native** (package name: `engage-native`) is the native mobile app for D-Sports. It mirrors the core PWA experience on iOS and Android: wallet, shop, leaderboard, locker room, and profile.
 
 - **Run:** `bunx expo start` or `bun run start` — then press `a` for Android or `i` for iOS, or scan the QR code with Expo Go.
 
@@ -17,18 +17,18 @@
 | Framework  | Expo 54, React Native 0.81, React 19 |
 | Auth       | Clerk (Expo)              |
 | Payments   | RevenueCat (react-native-purchases) |
 | Web3       | Thirdweb                  |
 | State      | Zustand                   |
 | Storage    | MMKV                      |
 | UI         | Lucide React Native       |
 | Navigation | Expo Router               |
 | Package    | Bun                       |
 
 ## Features
 
 - **Wallet** — Tokens, holdings, pack opening, crypto checkout (via PWA backend)
 - **Shop** — Collectibles, cart, coin bundles, checkout
 - **Leaderboard** — Rankings and filters
 - **Locker room** — Social feed and engagement
 - **Profile** — User profile and settings
 - **Theme** — Dark/light mode (default dark)
@@ -36,12 +36,77 @@
 ## Getting started
 
 1. Clone the repository and run `bun install`.
 2. Configure environment (Clerk, RevenueCat, Thirdweb, API base URL) per repo README.
 3. Run `bunx expo start`.
 4. For development builds: `bun run build:dev` (EAS) or run with Expo dev client.
 
 The app targets both native and web (responsive) and uses the same backend (d-sports-api) as the PWA for API and checkout flows.
 
+## EAS builds
+
+Expo Application Services (EAS) handles native builds, OTA updates, and store submissions. All EAS CLI commands use `bunx eas-cli` via npm scripts.
+
+### Development builds
+
+Development builds include `expo-dev-client` for dev menu, fast refresh, and JS updates without rebuilding native binaries.
+
+```bash
+# iOS simulator
+bun run build:dev:ios
+
+# Android APK
+bun run build:dev:android
+
+# Both platforms
+bun run build:dev
+```
+
+After building, start the dev server with:
+
+```bash
+bunx expo start --dev-client
+```
+
+### Preview builds
+
+Preview builds are release-mode binaries for internal QA and stakeholder testing.
+
+```bash
+bun run build:preview
+```
+
+### Production builds
+
+Production builds are store-ready with auto-incrementing build numbers.
+
+```bash
+bun run build:prod
+```
+
+### OTA updates
+
+Push JS/asset changes to existing installs without a new store build:
+
+```bash
+# Push to production channel
+bun run update --branch production --message "Fix: wallet balance display"
+```
+
+<Note>
+OTA updates only work if JS is compatible with the installed native binary. If you add or change native modules, do a full build first.
+</Note>
+
+### Store submission
+
+```bash
+# Submit both platforms
+bun run submit
+
+# Single platform
+bun run submit:ios
+bun run submit:android
+```
+
 <Card title="Ecosystem overview" icon="map" href="/repositories/ecosystem-overview">
   See how the native app fits with the PWA, site, and Mic'd Up.
 </Card>