Merge pull request #18 from objectstack-ai/copilot/update-npm-to-pnpm

Author: hotlong

.github/workflows/ci.yml

@@ -15,11 +15,14 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10
       - uses: actions/setup-node@v4
         with:
           node-version: 20
-          cache: npm
-      - run: npm ci --legacy-peer-deps
+          cache: pnpm
+      - run: pnpm install
       - name: Type Check
         run: npx tsc --noEmit
       - name: Lint

.github/workflows/eas-build.yml

@@ -33,15 +33,18 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10
       - uses: actions/setup-node@v4
         with:
           node-version: 20
-          cache: npm
+          cache: pnpm
       - uses: expo/expo-github-action@v8
         with:
           eas-version: latest
           token: ${{ secrets.EXPO_TOKEN }}
-      - run: npm ci --legacy-peer-deps
+      - run: pnpm install
       - name: Build iOS
         if: inputs.platform == 'ios' || inputs.platform == 'all' || inputs.platform == ''
         run: eas build --platform ios --profile ${{ inputs.profile || 'preview' }} --non-interactive

.github/workflows/eas-submit.yml

@@ -20,14 +20,17 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10
       - uses: actions/setup-node@v4
         with:
           node-version: 20
-          cache: npm
+          cache: pnpm
       - uses: expo/expo-github-action@v8
         with:
           eas-version: latest
           token: ${{ secrets.EXPO_TOKEN }}
-      - run: npm ci --legacy-peer-deps
+      - run: pnpm install
       - name: Submit
         run: eas submit --platform ${{ inputs.platform }} --profile production --non-interactive

.github/workflows/eas-update.yml

@@ -19,14 +19,17 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10
       - uses: actions/setup-node@v4
         with:
           node-version: 20
-          cache: npm
+          cache: pnpm
       - uses: expo/expo-github-action@v8
         with:
           eas-version: latest
           token: ${{ secrets.EXPO_TOKEN }}
-      - run: npm ci --legacy-peer-deps
+      - run: pnpm install
       - name: Publish update
         run: eas update --auto --non-interactive --message "${{ inputs.message || 'OTA update' }}"

.gitignore

@@ -3,6 +3,9 @@
 # dependencies
 node_modules/
 
+# pnpm
+.pnpm-store/
+
 # Expo
 .expo/
 dist/

.npmrc

@@ -0,0 +1,3 @@
+strict-peer-dependencies=false
+auto-install-peers=true
+shamefully-hoist=true

README.md

@@ -24,13 +24,13 @@ Enterprise low-code platform mobile runtime built with Expo, React Native, and T
 
 ```bash
 # Install dependencies
-npm install --legacy-peer-deps
+pnpm install
 
 # Copy environment variables
 cp .env.example .env.local
 
 # Start development server
-npx expo start
+pnpm start
 ```
 
 ## Project Structure
@@ -60,10 +60,10 @@ npx expo start
 
 | Command | Description |
 |---------|-------------|
-| `npm start` | Start Expo development server |
-| `npm run lint` | TypeScript check + ESLint |
-| `npm test` | Run Jest tests |
-| `npm run format` | Format with Prettier |
+| `pnpm start` | Start Expo development server |
+| `pnpm run lint` | TypeScript check + ESLint |
+| `pnpm test` | Run Jest tests |
+| `pnpm run format` | Format with Prettier |
 
 ## Documentation
 

docs/CONTRIBUTING.md

@@ -29,7 +29,7 @@
 | Tool | Version | Purpose |
 |------|---------|---------|
 | **Node.js** | ≥ 20.x | Runtime |
-| **npm** | ≥ 10.x | Package manager |
+| **pnpm** | ≥ 10.x | Package manager |
 | **Expo CLI** | Latest | Development tools |
 | **Xcode** | ≥ 15 (macOS) | iOS simulator |
 | **Android Studio** | Latest | Android emulator |
@@ -42,7 +42,7 @@ git clone https://github.com/objectstack-ai/mobile.git
 cd mobile
 
 # 2. Install dependencies
-npm install --legacy-peer-deps
+pnpm install
 
 # 3. Copy environment variables
 cp .env.example .env.local
@@ -51,21 +51,21 @@ cp .env.example .env.local
 # Edit .env.local: EXPO_PUBLIC_API_URL=http://localhost:3000
 
 # 5. Start development server
-npx expo start
+pnpm start
 ```
 
 ### Available Commands
 
 | Command | Description |
 |---------|-------------|
-| `npm start` | Start Expo development server |
-| `npm run android` | Start on Android |
-| `npm run ios` | Start on iOS |
-| `npm run web` | Start on web |
-| `npm run lint` | Run TypeScript check + ESLint |
-| `npm test` | Run Jest tests |
-| `npm run format` | Format code with Prettier |
-| `npm run format:check` | Check formatting without changes |
+| `pnpm start` | Start Expo development server |
+| `pnpm run android` | Start on Android |
+| `pnpm run ios` | Start on iOS |
+| `pnpm run web` | Start on web |
+| `pnpm run lint` | Run TypeScript check + ESLint |
+| `pnpm test` | Run Jest tests |
+| `pnpm run format` | Format code with Prettier |
+| `pnpm run format:check` | Check formatting without changes |
 
 ---
 
@@ -206,7 +206,7 @@ mobile/
 2. Make changes with small, focused commits
 
 3. Run checks before pushing
-   npm run lint && npm test
+   pnpm run lint && pnpm test
 
 4. Push and create PR against develop
    git push origin feature/my-feature
@@ -509,8 +509,8 @@ chore(deps): update expo SDK to 54.0.33
 
 - [ ] TypeScript compiles without errors (`npx tsc --noEmit`)
 - [ ] ESLint passes (`npx eslint . --ext .ts,.tsx`)
-- [ ] Tests pass (`npm test`)
-- [ ] Code is formatted (`npm run format:check`)
+- [ ] Tests pass (`pnpm test`)
+- [ ] Code is formatted (`pnpm run format:check`)
 - [ ] New code has appropriate types (no unnecessary `any`)
 - [ ] New components have `accessibilityLabel` props
 - [ ] Documentation updated if API changed
@@ -578,8 +578,8 @@ How to verify the changes.
 
 | Issue | Solution |
 |-------|----------|
-| **Install fails** | Use `npm install --legacy-peer-deps` |
-| **Metro cache issues** | `npx expo start --clear` |
+| **Install fails** | Use `pnpm install --no-frozen-lockfile` |
+| **Metro cache issues** | `pnpm start --clear` |
 | **TypeScript errors** | `npx tsc --noEmit` to check |
 | **NativeWind not updating** | Restart Metro bundler |
 | **Expo Go crash** | Use development build instead |
@@ -589,7 +589,7 @@ How to verify the changes.
 
 ```bash
 # Clear all caches
-npx expo start --clear
+pnpm start --clear
 
 # Reset Metro cache
 npx react-native start --reset-cache
@@ -601,7 +601,7 @@ npx expo-doctor
 npx tsc --noEmit
 
 # Fix formatting
-npm run format
+pnpm run format
 ```
 
 ---

docs/DEPLOYMENT.md

@@ -44,15 +44,15 @@ The app uses Expo's **managed workflow**, which means:
 
 ```bash
 # Install dependencies
-npm install --legacy-peer-deps
+pnpm install
 
 # Start development server
-npx expo start
+pnpm start
 
 # Start on specific platform
-npx expo start --ios
-npx expo start --android
-npx expo start --web
+pnpm start --ios
+pnpm start --android
+pnpm start --web
 
 # Type check
 npx tsc --noEmit
@@ -64,7 +64,7 @@ npx eslint . --ext .ts,.tsx
 npx prettier --write "**/*.{ts,tsx,js,json}"
 
 # Test
-npm test
+pnpm test
 ```
 
 ---
@@ -161,10 +161,10 @@ export default ({ config }: ConfigContext): ExpoConfig => ({
 
 ```
 1. Clone repository
-2. npm install --legacy-peer-deps
+2. pnpm install
 3. Copy .env.example → .env.local
 4. Configure EXPO_PUBLIC_API_URL
-5. npx expo start
+5. pnpm start
 6. Open on device/simulator
 ```
 
@@ -230,7 +230,7 @@ eas build --platform all --profile production
 Source Code
     ↓
 EAS Build (Cloud)
-    ├── Install dependencies (npm ci)
+    ├── Install dependencies (pnpm install)
     ├── Run prebuild hooks
     ├── Generate native projects
     ├── Compile native code (Xcode / Gradle)
@@ -333,7 +333,7 @@ Push / PR
               ↓
 ┌───────────────────────────┐
 │  Unit & Integration Tests  │
-│  npm test -- --coverage    │
+│  pnpm test -- --coverage   │
 └─────────────┬─────────────┘
               ↓
 ┌───────────────────────────┐
@@ -360,14 +360,17 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10
       - uses: actions/setup-node@v4
         with:
           node-version: "20"
-          cache: "npm"
-      - run: npm ci --legacy-peer-deps
+          cache: "pnpm"
+      - run: pnpm install
       - run: npx tsc --noEmit
       - run: npx eslint . --ext .ts,.tsx
-      - run: npm test -- --coverage --ci
+      - run: pnpm test -- --coverage --ci
 ```
 
 #### Build on Merge
@@ -383,15 +386,18 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10
       - uses: actions/setup-node@v4
         with:
           node-version: "20"
-          cache: "npm"
+          cache: "pnpm"
       - uses: expo/expo-github-action@v8
         with:
           eas-version: latest
           token: ${{ secrets.EXPO_TOKEN }}
-      - run: npm ci --legacy-peer-deps
+      - run: pnpm install
       - run: eas build --platform all --profile preview --non-interactive
 ```
 
@@ -408,15 +414,18 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10
       - uses: actions/setup-node@v4
         with:
           node-version: "20"
-          cache: "npm"
+          cache: "pnpm"
       - uses: expo/expo-github-action@v8
         with:
           eas-version: latest
           token: ${{ secrets.EXPO_TOKEN }}
-      - run: npm ci --legacy-peer-deps
+      - run: pnpm install
       - run: eas update --branch production --message "${{ github.ref_name }}"
 ```
 
@@ -473,8 +482,8 @@ npm version major
 
 ```
 1. Create release branch: release/v1.x.x
-2. Run full test suite: npm test -- --coverage
-3. Bump version: npm version minor
+2. Run full test suite: pnpm test -- --coverage
+3. Bump version: pnpm version minor
 4. Build production: eas build --platform all --profile production
 5. Test builds on devices
 6. Submit to stores: eas submit --platform all --profile production