chore: replace Yarn with pnpm (#306)

* chore: replace Yarn with pnpm

* chore: update remaining Yarn references in scripts and CI workflows

* chore: remove `useWorkspaces` from `lerna.json`

* chore: add Jest

* chore: remove `prepublishOnly` scripts

* chore: replace Lerna commands with pnpm equivalents in root `package.json`

* chore: update template

* chore: replace Lerna commands with pnpm equivalents

* chore: use pnpm's `workspace:*` protocol for `apps/*`

* chore: use pnpm catalogs

* docs: update publishing instructions to be more accurate

Author: hassankhan

.github/workflows/lint-md.yml

@@ -15,6 +15,11 @@ jobs:
   lint-md:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-      - run: yarn install --frozen-lockfile --check-files
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
       - run: npx remark --use validate-links . .github

.github/workflows/test.yml

@@ -13,15 +13,17 @@ jobs:
         node: ["20", "22"]
     name: Build with Node ${{ matrix.node }}
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
         with:
           fetch-depth: 1
+      - uses: pnpm/action-setup@v4
       - name: Setup node
-        uses: actions/setup-node@v1
+        uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node }}
-      - run: yarn install --frozen-lockfile --check-files
-      - run: yarn lerna run prepare --stream
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm --filter './packages/*' --parallel run prepare
       - uses: actions/cache@v4
         with:
           path: "*"
@@ -47,15 +49,17 @@ jobs:
         with:
           path: "*"
           key: v2-${{ github.sha }}-${{ matrix.node }}
+      - uses: pnpm/action-setup@v4
       - name: Set up Node
-        uses: actions/setup-node@v1
+        uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node }}
+          cache: pnpm
       - name: Lint ${{ matrix.package }}
-        run: yarn lint --max-warnings 0
+        run: pnpm lint --max-warnings 0
         working-directory: packages/${{ matrix.package }}
       - name: Test ${{ matrix.package }}
-        run: yarn test
+        run: pnpm test
         working-directory: packages/${{ matrix.package }}
         env:
           CI: true

.gitignore

@@ -9,7 +9,7 @@ web-build
 # Node
 node_modules
 npm-debug.log
-yarn-error.log
+pnpm-debug.log
 
 # Ruby
 .direnv

CLAUDE.md

@@ -5,38 +5,38 @@
 Monorepo of community-maintained Expo config plugins for React Native libraries. Plugins auto-configure native Android/iOS projects during `npx expo prebuild`.
 
 - **Namespace**: `@config-plugins/*`
-- **Package manager**: Yarn v1 with workspaces
-- **Orchestrator**: Lerna 3.4.1 (independent versioning)
+- **Package manager**: pnpm with workspaces
+- **Publishing**: `pnpm publish` (independent versioning)
 
 ## Common Commands
 
 ```bash
 # Install dependencies
-yarn
+pnpm install
 
 # Build all packages
-yarn prepare
+pnpm prepare
 
 # Watch build all packages
-yarn start
+pnpm start
 
 # Generate a new plugin
-yarn gen
+pnpm gen
 
 # Run tests for a specific package
-cd packages/<name> && yarn test
+cd packages/<name> && pnpm test
 
 # Lint a specific package
-cd packages/<name> && yarn lint --max-warnings 0
+cd packages/<name> && pnpm lint --max-warnings 0
 
 # Build a specific package
-cd packages/<name> && yarn build
+cd packages/<name> && pnpm build
 
 # Clean a specific package
-cd packages/<name> && yarn clean
+cd packages/<name> && pnpm clean
 
 # Rebuild an example app to test config plugins
-cd apps/<name> && yarn expo prebuild --clean
+cd apps/<name> && pnpm expo prebuild --clean
 ```
 
 ## Project Structure
@@ -52,20 +52,29 @@ cd apps/<name> && yarn expo prebuild --clean
 - Branch naming: `@your-github-username/type/description`
 - Each package delegates build/test/lint to `expo-module-scripts`
 - TypeScript source in `src/`, compiled output in `build/`
+- Shared dependency versions are defined in the `catalog:` block in `pnpm-workspace.yaml` and referenced with `catalog:` in each package's `package.json`
 - Peer dependency on `expo@^55`
 - Tests use Jest with `memfs` for virtual filesystem testing
 
 ## Upgrading Plugins for a New Expo SDK Version
 
 When a new Expo SDK is released (e.g., SDK 54 → SDK 55), every package and example app must be updated. Use conventional commits scoped to the package name (e.g., `chore(react-native-foo): bump to expo@^55`).
 
+### Catalog updates (`pnpm-workspace.yaml`)
+
+Update the `catalog:` block with the new SDK versions for shared dependencies:
+
+1. **`expo`** — Update to `^<NEW_SDK>` (used as `peerDependencies` in all packages).
+2. **`expo-module-scripts`** — Update to `^<NEW_SDK>`.
+3. **`@expo/config-plugins`** — Update to `^<NEW_SDK>`.
+4. Review other catalog entries (`@expo/image-utils`, `@expo/plist`, etc.) and bump if needed.
+
 ### Per-package updates (`packages/<name>/`)
 
 For each package:
 
-1. **`package.json`** — Update `peerDependencies.expo` to `^<NEW_SDK>`.
-2. **`README.md`** — Add a new row to the version compatibility table with the new SDK version, the latest compatible upstream package version, and the next config plugin major version.
-3. **Build & test** — Run `yarn build` and `yarn test` (if tests exist) to verify nothing broke.
+1. **`README.md`** — Add a new row to the version compatibility table with the new SDK version, the latest compatible upstream package version, and the next config plugin major version.
+2. **Build & test** — Run `pnpm build` and `pnpm test` (if tests exist) to verify nothing broke.
 
 ### Example app updates (`apps/<name>/`)
 
@@ -77,21 +86,19 @@ For each example app:
 
 ### Monorepo root updates
 
-1. **`package.json`** — Update `expo-module-scripts` to the version matching the new SDK (e.g., `^55.0.2`).
-2. **`scripts/generate-plugin.ts`** — Update `SDK_VERSION` to the new SDK number.
-3. **`scripts/template/package.json`** — Update the `expo` peer dependency version.
+1. **`scripts/generate-plugin.ts`** — Update `SDK_VERSION` to the new SDK number.
 
 ### Final steps
 
-1. Run `yarn` from the root to regenerate `yarn.lock`.
-2. Run `yarn prepare` to verify all packages build.
+1. Run `pnpm install` from the root to regenerate `pnpm-lock.yaml`.
+2. Run `pnpm prepare` to verify all packages build.
 3. Run tests for packages that have them.
 4. Update `CLAUDE.md` if any conventions changed (e.g., the peer dependency version listed under Conventions).
 
 ## After Adding/Removing Packages
 
 Run these from the root:
 ```bash
-yarn update-dependabot-config
-yarn update-issue-template
+pnpm update-dependabot-config
+pnpm update-issue-template
 ```

CONTRIBUTING.md

@@ -5,27 +5,27 @@
 To submit a pull request:
 
 1. Fork the [repository](https://github.com/expo/config-plugins) and create a feature branch. (Existing contributors can create feature branches without forking. Prefix the branch name with `@your-github-username/`.)
-2. Run `yarn` in the root directory to generate the build files.
+2. Run `pnpm install` in the root directory to generate the build files.
 3. Use [conventional commits](https://www.conventionalcommits.org/en/v1.0.0/) including in the PR title.
 4. Fill out the entire PR template. Ensure your code is tested locally and has continuous tests in CI.
 5. Make sure all tests pass on GitHub Actions.
 6. Wait for a review and adjust the code if necessary.
 
 ## Creating a plugin
 
-- Plugins can be generated by running `yarn gen`.
+- Plugins can be generated by running `pnpm gen`.
 - Add plugins to the example in [`apps/app`](/apps/app/package.json) to test them.
 - The example app should always stay in a state of regeneration.
 
 Be sure to run the following scripts in the **root directory** to update automation tools:
 
-- Update dependabot: `yarn update-dependabot-config`
-- Update the issue template: `yarn update-issue-template`
+- Update dependabot: `pnpm update-dependabot-config`
+- Update the issue template: `pnpm update-issue-template`
 
 ## Upgrading plugins for a new Expo version
 
+- Update the `catalog:` block in `pnpm-workspace.yaml` with the new SDK versions for `expo`, `expo-module-scripts`, `@expo/config-plugins`, and any other shared dependencies
 - Ensure every project under `apps/` is updated to latest version of Expo
-- Ensure every library under `packages/` has a peer dependency on the same version of Expo
 - Update each library’s `README.md`
   - Ensuring the latest version of Expo is listed
   - Ensure the upstream package version is correct
@@ -34,4 +34,7 @@ Be sure to run the following scripts in the **root directory** to update automat
 
 ## Publishing a release
 
-All publishing should be handled automatically whenever code is merged to `main`.
+Packages are published manually using the scripts in the root `package.json`:
+
+1. `pnpm bump`: Increments the major version of all packages.
+2. `pnpm release`: Publishes all packages to npm.

apps/app/package.json

@@ -9,8 +9,8 @@
     "android": "expo run:android"
   },
   "dependencies": {
-    "@config-plugins/react-native-adjust": "*",
-    "@config-plugins/react-native-callkeep": "*",
+    "@config-plugins/react-native-adjust": "workspace:*",
+    "@config-plugins/react-native-callkeep": "workspace:*",
     "expo": "~55",
     "expo-localization": "~55.0.9",
     "expo-splash-screen": "~55.0.12",

apps/apple-settings/package.json

@@ -9,7 +9,7 @@
     "e2e": "maestro test .maestro/"
   },
   "dependencies": {
-    "@config-plugins/apple-settings": "*",
+    "@config-plugins/apple-settings": "workspace:*",
     "@react-native-community/slider": "5.1.2",
     "@react-native-picker/picker": "2.11.4",
     "expo": "~55",

apps/ios-stickers/package.json

@@ -7,7 +7,7 @@
     "android": "expo run:android"
   },
   "dependencies": {
-    "@config-plugins/ios-stickers": "*",
+    "@config-plugins/ios-stickers": "workspace:*",
     "expo": "~55",
     "expo-splash-screen": "~55.0.12",
     "react": "19.2.0",

apps/react-native-branch/package.json

@@ -8,7 +8,7 @@
     "android": "expo run:android"
   },
   "dependencies": {
-    "@config-plugins/react-native-branch": "*",
+    "@config-plugins/react-native-branch": "workspace:*",
     "expo": "~55",
     "expo-splash-screen": "~55.0.12",
     "react": "19.2.0",

apps/react-native-dynamic-app-icon/package.json

@@ -8,7 +8,7 @@
     "android": "expo run:android"
   },
   "dependencies": {
-    "@config-plugins/react-native-dynamic-app-icon": "*",
+    "@config-plugins/react-native-dynamic-app-icon": "workspace:*",
     "expo": "~55",
     "expo-splash-screen": "~55.0.12",
     "react": "19.2.0",