byGalax
b1cdc4d184
Three small follow-ups from the post-Phase-1 quality review:
* authContext.tsx — drop the dead `userId` extraction + the `void
userId` suppressor that masked an unused-locals warning. The session
is already implicitly threaded through the supabase client, so no
consumer of ensureDevice needed the value.
* authContext.tsx — switch the device-name string concat to a
template literal for consistency with the rest of the codebase.
* ErrorBoundary.tsx — replace the four inline hex literals with their
`theme/colors.ts` constants. The boundary was authored in Phase 0
before the theme module existed; this brings it in line with every
Phase 1 screen.
* apps/mobile/README.md — drop the stale Phase-0 paragraph about the
`lib/sharedSmoke.ts` canary (deleted in Phase 1) and add a short
pointer to the env-var setup.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
79 lines
2.7 KiB
Markdown
79 lines
2.7 KiB
Markdown
# @chat-app/mobile
|
|
|
|
Expo + React Native client for **Netralax** on iOS and Android.
|
|
|
|
## Prerequisites
|
|
|
|
- Node 22+, pnpm 9+
|
|
- Xcode (iOS) / Android Studio (Android) — only needed for local
|
|
prebuild + emulator runs; EAS Build runs everything in the cloud.
|
|
- An Expo account (free) — required for `eas init` below.
|
|
- Optional: `npm i -g eas-cli` for the CLI commands. If you skip
|
|
globals, prefix every `eas` invocation with `npx eas-cli`.
|
|
|
|
## Phase 0 quickstart
|
|
|
|
```bash
|
|
# From the repo root.
|
|
pnpm install
|
|
|
|
# One-time: claim an EAS project ID. This rewrites the placeholder
|
|
# `extra.eas.projectId` in app.json and links the local repo to your
|
|
# Expo dashboard. Commit the resulting app.json change.
|
|
cd apps/mobile
|
|
npx eas-cli init
|
|
|
|
# Sign in to Expo if you haven't.
|
|
npx eas-cli login
|
|
|
|
# Build a development client (custom dev-client APK + iOS simulator
|
|
# bundle). First iOS build prompts for Apple ID — free signing works
|
|
# for development distribution.
|
|
npx eas-cli build --platform all --profile development
|
|
```
|
|
|
|
When the builds finish, EAS gives you a QR code / install link. Install
|
|
the dev client on your device, then start the Metro server from the repo
|
|
root:
|
|
|
|
```bash
|
|
pnpm mobile:dev # = pnpm --filter @chat-app/mobile dev = expo start --dev-client
|
|
```
|
|
|
|
Open the dev client on the device, scan the QR code, and Netralax's
|
|
Landing screen should render.
|
|
|
|
## Day-to-day
|
|
|
|
```bash
|
|
pnpm mobile:dev # Metro server
|
|
pnpm mobile:ios # native iOS run (local Xcode)
|
|
pnpm mobile:android # native Android run (local Android Studio)
|
|
pnpm mobile:typecheck # tsc --noEmit
|
|
```
|
|
|
|
## Architecture notes
|
|
|
|
- Expo Router (file-based) — screens live under `app/`.
|
|
- `expo-secure-store` — Keychain / Keystore-backed secret store, wrapped
|
|
by `lib/secretStore.ts` to implement `@chat-app/shared`'s `SecretStore`.
|
|
- `@react-native-async-storage/async-storage` — Supabase session-token
|
|
storage, surfaced via `lib/sessionStorage.ts`.
|
|
- `expo-sqlite` — local encrypted history (slated for a later phase).
|
|
- `react-native-libsodium` — crypto primitives, wrapped by
|
|
`lib/cryptoBackend.ts` to implement `@chat-app/shared`'s `CryptoBackend`.
|
|
Registered once at boot in `app/_layout.tsx`.
|
|
- `@chat-app/shared` — business logic shared with the desktop; the mobile
|
|
adapters plug into its `CryptoBackend` + `SecretStore` interfaces, and
|
|
every chat / auth call goes through the namespace exports.
|
|
|
|
## Env vars
|
|
|
|
Copy `.env.example` to `.env.local` and fill in the same Supabase host +
|
|
anon key the desktop uses. Expo bundles only `EXPO_PUBLIC_*`-prefixed
|
|
vars into the JS, which is what the three required values use.
|
|
|
|
## Roadmap
|
|
|
|
See `docs/superpowers/specs/2026-05-13-mobile-deployment-roadmap.md`.
|