CLAUDE.md

1# apps/mobile — Claude context
2 
3Expo Router mobile app (`@medlens/mobile`), built with React Native and TypeScript.
4 
5## Commands
6 
7```bash
8pnpm --filter @medlens/mobile dev
9pnpm --filter @medlens/mobile start
10pnpm --filter @medlens/mobile lint
11pnpm --filter @medlens/mobile typecheck
12pnpm --filter @medlens/mobile test
13pnpm --filter @medlens/mobile build
14```
15 
16## Layout
17 
18- `src/app/` — file-based Expo Router screens and layouts
19- `src/components/` — shared UI, themed wrappers, and app-shell pieces
20- `src/constants/` — theme, spacing, and shared constants
21- `src/hooks/` — reusable hooks
22- `assets/images/` — app icons, logos, splash assets, and branding
23- `assets/expo.icon/` — Expo icon assets
24- Shared types: `@medlens/types` from `packages/types`
25- Shared logger: `@medlens/logger` from `packages/logger`
26 
27## Conventions
28 
29- Use Expo Router file-based routing; keep screens in `src/app/` and shared UI in `src/components/`.
30- Prefer typed contracts and shared package usage over duplicating logic in the app.
31- Respect platform differences with `Platform.select` and cross-platform-safe patterns.
32- Keep the mobile branding aligned with the web product assets and app identity.
33- No medical interpretation logic in the UI; API owns clinical semantics.
34- No PHI in logs or analytics; follow the repository safety and privacy guardrails.
35 
36## Guidance for agents
37 
38- Treat this app as an Expo Router + React Native project and follow the official Expo, Expo Router, and React Native guidance for navigation, asset handling, and platform-specific behavior.
39- When introducing new components or native integrations, consult the official package documentation before implementing them.
40- Keep the mobile experience consistent with the web and API apps by following shared contracts, package conventions, and repository safety rules.
41 
42## Skills by surface
43 
44**Mobile UI:** `product-ux`, `ui-accessibility`, `web-performance`
45 
46**Always:** `safety-privacy` for health-related copy and logging
47 
48Commands: `/ui-audit`, `/perf-review` · Map: `docs/00-start/03-RULES_AND_SKILLS_MAP.md`
49