chore: 실기기 개발 명령 정리

Author: choihooo

README.md

@@ -28,45 +28,31 @@ apps/web/src/bridge.ts            # typed web client
 ```bash
 nvm use
 pnpm install
+pnpm dev:device
 pnpm dev:web
-pnpm dev:web:lan
 pnpm dev:storybook
 pnpm dev:mobile
-pnpm dev:mobile-client
 pnpm typecheck
 pnpm lint
 pnpm format
 ```
 
 웹 개발 서버는 기본적으로 `http://127.0.0.1:5173`에서 실행됩니다.
 
-실기기에서 Expo Go로 테스트할 때는 Mac의 LAN IP를 `.env`에 넣어야 합니다.
+실기기에서 Expo Go로 테스트할 때는 아래 명령을 사용합니다. 실행 시점의 Mac LAN IP를 자동으로 감지해 WebView URL에 주입합니다.
 
 ```bash
-cp .env.example .env
-```
-
-```env
-EXPO_PUBLIC_WEB_URL=http://YOUR_MAC_LAN_IP:5173
-```
-
-그 경우 웹 서버는 LAN용 명령으로 실행합니다.
-
-```bash
-pnpm dev:web:lan
+pnpm dev:device
 ```
 
 ## Useful Commands
 
 ```bash
 pnpm dev          # web + mobile-shell 전체 dev task
 pnpm dev:web      # React web만 실행, local/simulator
-pnpm dev:web:lan  # React web을 LAN 접근 가능하게 실행, 실기기용
+pnpm dev:device   # 실기기 테스트용, web + Expo Go 서버 실행
 pnpm dev:storybook # 디자인 시스템 Storybook 실행
 pnpm dev:mobile   # Expo shell만 실행
-pnpm dev:mobile-client # installed dev-client 앱에 연결
-pnpm ios:dev-client    # iOS dev-client 빌드/실행
-pnpm android:dev-client # Android dev-client 빌드/실행
 pnpm typecheck    # 전체 타입체크
 pnpm lint         # Biome 검사
 pnpm format       # Biome 포맷
@@ -125,19 +111,3 @@ revert
 초기 세팅 추가
 버그 수정
 ```
-
-## Expo Dev Client
-
-Expo Go로 충분한 동안은 `pnpm dev:mobile`을 쓰면 됩니다. 네이티브 SDK나 config plugin이 필요해지면 dev-client 앱을 한 번 빌드한 뒤 사용합니다.
-
-```bash
-pnpm ios:dev-client
-# or
-pnpm android:dev-client
-```
-
-이후에는 아래 명령으로 Metro를 dev-client 모드로 실행합니다.
-
-```bash
-pnpm dev:mobile-client
-```

apps/mobile-shell/index.ts

@@ -0,0 +1,4 @@
+import { registerRootComponent } from 'expo';
+import App from './App';
+
+registerRootComponent(App);

apps/mobile-shell/package.json

@@ -2,30 +2,27 @@
   "name": "@comma/mobile-shell",
   "private": true,
   "version": "0.0.0",
-  "main": "expo/AppEntry.js",
+  "main": "index.ts",
   "scripts": {
     "dev": "expo start",
-    "dev:client": "expo start --dev-client",
+    "dev:device": "expo start --go --lan",
     "android": "expo start --android",
-    "android:dev-client": "expo run:android",
     "ios": "expo start --ios",
-    "ios:dev-client": "expo run:ios",
     "web": "expo start --web",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "@comma/bridge": "workspace:*",
     "@webview-bridge/react-native": "^1.7.9",
-    "expo": "~53.0.27",
-    "expo-dev-client": "~5.2.4",
-    "expo-status-bar": "^2.2.0",
-    "react": "19.0.0",
-    "react-native": "0.79.6",
-    "react-native-webview": "13.13.5",
+    "expo": "~54.0.35",
+    "expo-status-bar": "^3.0.9",
+    "react": "19.1.0",
+    "react-native": "0.81.5",
+    "react-native-webview": "13.15.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@types/react": "~19.0.10",
-    "typescript": "~5.8.3"
+    "@types/react": "~19.1.17",
+    "typescript": "~5.9.3"
   }
 }

apps/web/package.json

@@ -5,7 +5,7 @@
   "type": "module",
   "scripts": {
     "dev": "vite --host 127.0.0.1",
-    "dev:lan": "vite --host 0.0.0.0",
+    "dev:device": "vite --host 0.0.0.0 --strictPort",
     "build": "tsc -b && vite build",
     "typecheck": "tsc --noEmit"
   },

package.json

@@ -5,12 +5,9 @@
   "scripts": {
     "dev": "turbo dev",
     "dev:web": "turbo dev --filter=@comma/web",
-    "dev:web:lan": "pnpm --filter @comma/web dev:lan",
     "dev:storybook": "pnpm --filter @comma/storybook dev",
+    "dev:device": "sh ./scripts/dev-device.sh",
     "dev:mobile": "turbo dev --filter=@comma/mobile-shell",
-    "dev:mobile-client": "pnpm --filter @comma/mobile-shell dev:client",
-    "ios:dev-client": "pnpm --filter @comma/mobile-shell ios:dev-client",
-    "android:dev-client": "pnpm --filter @comma/mobile-shell android:dev-client",
     "build:storybook": "pnpm --filter @comma/storybook build-storybook",
     "build": "turbo build",
     "typecheck": "turbo typecheck",