Files

T

byGalax b1cdc4d184 chore(mobile): phase 1 quality-review fixups

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>

2026-05-14 00:08:22 +02:00

2.7 KiB

Raw Blame History

@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

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

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

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.

2.7 KiB Raw Blame History