✨ 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

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'

bin/yarn

@@ -1,17 +1,18 @@
 #!/usr/bin/env ruby
 APP_ROOT = File.expand_path('..', __dir__)
 Dir.chdir(APP_ROOT) do
-  yarn = ENV["PATH"].split(File::PATH_SEPARATOR).
-    select { |dir| File.expand_path(dir) != __dir__ }.
-    product(["yarn", "yarn.cmd", "yarn.ps1"]).
+  pnpm = ENV.fetch("PATH", "").split(File::PATH_SEPARATOR).
+    reject { |dir| File.expand_path(dir) == __dir__ }.
+    product(["pnpm", "pnpm.cmd", "pnpm.ps1"]).
     map { |dir, file| File.expand_path(file, dir) }.
     find { |file| File.executable?(file) }
 
-  if yarn
-    exec yarn, *ARGV
+  if pnpm
+    warn "Deprecated: bin/yarn now proxies to pnpm. Update scripts to use bin/pnpm." unless ENV["PNPM_PROXY_SILENT"]
+    exec pnpm, *ARGV
   else
-    $stderr.puts "Yarn executable was not detected in the system."
-    $stderr.puts "Download Yarn at https://yarnpkg.com/en/docs/install"
+    $stderr.puts "pnpm executable was not detected in the system."
+    $stderr.puts "Install pnpm via https://pnpm.io/installation"
     exit 1
   end
 end

config/webpacker.yml

@@ -52,8 +52,8 @@ development:
   <<: *default
   compile: true
 
-  # Verifies that correct packages and versions are installed by inspecting package.json, yarn.lock, and node_modules
-  check_yarn_integrity: true
+  # Legacy option retained for compatibility; pnpm's lockfile is validated via install flags instead.
+  check_yarn_integrity: false
 
   # Reference: https://webpack.js.org/configuration/dev-server/
   dev_server: