✨ Current rails project using yarn as package manager, please change to pnpm, also keep yarn.lock version as same as possible. You may need to search web first to see any relative standard migration process or guide.

Author: Eric-Guo

.circleci/config.yml

@@ -16,12 +16,10 @@ jobs:
     steps:
       - checkout # pull down our git code.
       - ruby/install-deps # use the ruby orb to install dependencies
-      # use the node orb to install our packages
-      # specifying that we use `yarn` and to cache dependencies with `yarn.lock`
-      # learn more: https://circleci.com/docs/2.0/caching/
+      # use the node orb to install our packages with pnpm and cache using pnpm-lock.yaml
       - node/install-packages:
-          pkg-manager: yarn
-          cache-key: "yarn.lock"
+          pkg-manager: pnpm
+          cache-key: "pnpm-lock.yaml"
 
   test:  # our next job, called "test"
     docker:
@@ -51,8 +49,8 @@ jobs:
       - browser-tools/install-chrome
       - ruby/install-deps
       - node/install-packages:
-          pkg-manager: yarn
-          cache-key: "yarn.lock"
+          pkg-manager: pnpm
+          cache-key: "pnpm-lock.yaml"
       - run:
           name: Check browser install
           command: |

.gitlab-ci.yml

@@ -8,6 +8,13 @@ before_script:
   - gem install bundler
   - bundle config set path 'vendor'  # Install dependencies into ./vendor/ruby
   - sed -i 's/mutex_m (0.2.0)/mutex_m (0.1.1)/g' Gemfile.lock
+  - |
+    if command -v corepack >/dev/null; then
+      corepack enable pnpm
+      corepack prepare pnpm@latest --activate
+    else
+      npm install -g pnpm@8
+    fi
 
 stages:
   - test
@@ -23,12 +30,12 @@ test:
         - vendor/ruby
     - key:
         files:
-          - yarn.lock
+          - pnpm-lock.yaml
       paths:
-        - ".yarn-cache/"
+        - ".pnpm-store/"
   script:
     - bundle install -j $(nproc)
-    - yarn install --cache-folder .yarn-cache
+    - pnpm install --frozen-lockfile --store-dir .pnpm-store
     - cp config/database.yml.sample config/database.yml
     - echo $RAILS_MASTER_KEY > config/master.key
     - bundle exec rails db:migrate RAILS_ENV=test

AGENTS.md

@@ -4,7 +4,7 @@
 Keep Rails domain logic inside `app/`, following conventional directories for controllers, models, policies, datatables, and views. Stimulus controllers and Webpacker packs live in `app/javascript`, while shared helpers and extensions belong in `lib/`. Configuration, environment credentials, and deployment hooks sit under `config/`, and migrations plus seeds live in `db/`. Test fixtures, unit specs, and system flows mirror the app layout within `test/`, with Capybara scenarios in `test/system/`.
 
 ## Build, Test, and Development Commands
-Run `bin/setup` after cloning or pulling to install Ruby gems, Yarn packages, and migrate the database. Start the Rails server via `bin/rails s`, and pair it with `bin/webpack-dev-server` or `foreman start -f Procfile.dev` for hot asset reloading. Sync front-end dependencies with `yarn install --check-files`. Execute the targeted test suite using `bin/rails test path/to/file_test.rb`, or run the full matrix through `bin/rails test:all`.
+Run `bin/setup` after cloning or pulling to install Ruby gems, PNPM packages, and migrate the database. Start the Rails server via `bin/rails s`, and pair it with `bin/webpack-dev-server` or `foreman start -f Procfile.dev` for hot asset reloading. Sync front-end dependencies with `pnpm install --frozen-lockfile`. Execute the targeted test suite using `bin/rails test path/to/file_test.rb`, or run the full matrix through `bin/rails test:all`.
 
 ## Coding Style & Naming Conventions
 Use Ruby two-space indentation and idiomatic Rails naming: `CamelCase` classes, snake_case files, and kebab-case Stimulus controllers in `app/javascript/controllers/`. Follow the cops configured in `.rubocop.yml`; run `bundle exec rubocop` before opening a pull request. JavaScript modules target ES2015 and are linted with the “recommended” ESLint profile defined in `.eslintrc.js`.

Capfile

@@ -30,7 +30,6 @@ install_plugin Capistrano::SCM::Git
 require 'capistrano/rbenv'
 # require 'capistrano/chruby'
 require 'capistrano/bundler'
-require 'capistrano/yarn'
 require 'capistrano/rails/assets'
 require 'capistrano/rails/migrations'
 # require "capistrano/passenger"

Dockerfile

@@ -24,12 +24,11 @@ RUN apt-get update -qq && \
 # Install curl and gpg
 RUN apt-get update && apt-get install -y curl gnupg
 
-# Install Node.js and Yarn
+# Install Node.js and pnpm
 RUN curl -sL https://deb.nodesource.com/setup_18.x | bash - && \
     apt-get install -y nodejs gcc g++ make && \
-    curl -sL https://dl.yarnpkg.com/debian/pubkey.gpg | gpg --dearmor | tee /usr/share/keyrings/yarnkey.gpg >/dev/null && \
-    echo "deb [signed-by=/usr/share/keyrings/yarnkey.gpg] https://dl.yarnpkg.com/debian stable main" | tee /etc/apt/sources.list.d/yarn.list && \
-    apt-get update && apt-get install -y yarn
+    corepack enable && \
+    corepack prepare pnpm@10.18.3 --activate
 
 # Install application gems
 COPY Gemfile Gemfile.lock ./
@@ -38,8 +37,8 @@ RUN bundle install && \
     bundle exec bootsnap precompile --gemfile
 
 # Install node modules
-COPY package.json yarn.lock ./
-RUN yarn install --frozen-lockfile    
+COPY package.json pnpm-lock.yaml ./
+RUN pnpm install --frozen-lockfile    
 
 # Copy application code
 COPY . .

Gemfile

@@ -96,7 +96,6 @@ group :development do
 
   gem 'capistrano3-puma', '~> 6.0'
   gem 'capistrano-rails'
-  gem 'capistrano-yarn'
   gem 'capistrano-rbenv'
   gem 'ed25519'
   gem 'bcrypt_pbkdf'

Gemfile.lock

@@ -155,8 +155,6 @@ GEM
     capistrano-rbenv (2.2.0)
       capistrano (~> 3.1)
       sshkit (~> 1.3)
-    capistrano-yarn (2.0.2)
-      capistrano (~> 3.0)
     capistrano3-puma (6.2.0)
       capistrano (~> 3.7)
       capistrano-bundler
@@ -480,7 +478,6 @@ DEPENDENCIES
   bootsnap (>= 1.18.4)
   capistrano-rails
   capistrano-rbenv
-  capistrano-yarn
   capistrano3-puma (~> 6.0)
   capybara (>= 3.40)
   csv

bin/pnpm

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path('..', __dir__)
+Dir.chdir(APP_ROOT) do
+  pnpm = ENV.fetch('PATH', '').split(File::PATH_SEPARATOR).
+    reject { |dir| File.expand_path(dir) == __dir__ }.
+    product(%w[pnpm pnpm.cmd pnpm.ps1]).
+    map { |dir, file| File.expand_path(file, dir) }.
+    find { |file| File.executable?(file) }
+
+  if pnpm
+    exec pnpm, *ARGV
+  else
+    $stderr.puts 'pnpm executable was not detected in the system.'
+    $stderr.puts 'Install pnpm via https://pnpm.io/installation'
+    exit 1
+  end
+end

bin/setup

@@ -18,7 +18,7 @@ FileUtils.chdir APP_ROOT do
   system("bundle check") || system!("bundle install")
 
   # Install JavaScript dependencies
-  system! 'bin/yarn'
+  system! 'bin/pnpm', 'install', '--frozen-lockfile'
 
   # puts "\n== Copying sample files =="
   # unless File.exist?("config/database.yml")

bin/update

@@ -17,8 +17,8 @@ chdir APP_ROOT do
   system! 'gem install bundler --conservative'
   system('bundle check') || system!('bundle install')
 
-  # Install JavaScript dependencies if using Yarn
-  # system('bin/yarn')
+  # Install JavaScript dependencies if needed
+  # system('bin/pnpm', 'install', '--frozen-lockfile')
 
   puts "\n== Updating database =="
   system! 'bin/rails db:migrate'