Update Ruby version to 3.3 (#1364)

justin808 · claude · web-flow · commit cd977b5b89c9 · 2026-02-14T21:36:16.000-10:00
* Prepare 3.3.0 release and update master to main references - Updated CHANGELOG.md with 3.3.0 release for Propshaft support - Renamed master branch references to main in documentation links - Updated VERSIONS.md to show main branch instead of master * Add Ruby 3.1, 3.2, and 3.3 support to CI - Update GitHub Actions workflows to test Ruby 2.7, 3.0, 3.1, 3.2, and 3.3 - Ensures compatibility across a wide range of Ruby versions - Rebuilt Gemfile.lock with Ruby 3.4 (compatible with 3.x) * Downgrade pry-byebug to support Ruby 2.7-3.3 The previous pry-byebug 3.11.0 required byebug ~> 12.0, which only supports Ruby >= 3.1. This caused CI failures on Ruby 3.0 because bundle lock would modify the Gemfile.lock during the build. This change constrains pry-byebug to ~> 3.8.0, which uses byebug ~> 11.0 that supports Ruby 2.7 through 3.3, ensuring the Gemfile.lock works across all supported Ruby versions without modification. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Update Nokogiri to 1.18.10 for Ruby 3.2+ compatibility The previous Nokogiri version 1.13.8 did not support Ruby 3.2+, causing CI test failures for Ruby 3.2 and 3.3. Updated all gemfile.lock files to use Nokogiri 1.18.10 which supports Ruby versions from 2.6 through 3.4+. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Add x86_64-linux-gnu platform to Gemfile.lock Nokogiri 1.18.10 uses x86_64-linux-gnu as the platform identifier instead of x86_64-linux. The CI workflow runs 'bundle lock --add-platform x86_64-linux' which was causing the lockfile to be modified because the platform wasn't pre-resolved. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Update CI workflow to use x86_64-linux-gnu platform Nokogiri 1.18.10+ uses x86_64-linux-gnu instead of x86_64-linux as the platform identifier. Updated the CI workflow to use the correct platform and removed the arm64-darwin-24 platform from Gemfile.lock to keep it consistent with CI expectations. This fixes the check_react_and_ujs test failures where Gemfile.lock was being modified during CI runs. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Use nokogiri 1.17.2 for Ruby 3.0-3.3 compatibility Nokogiri 1.18+ requires Ruby >= 3.2, which breaks Ruby 3.0 and 3.1 support. Additionally, nokogiri 1.18 changed the platform identifier from x86_64-linux to x86_64-linux-gnu, causing lockfile inconsistencies. Using nokogiri 1.17.2 which: - Supports the full Ruby 2.7-3.3 range - Uses the x86_64-linux platform identifier consistently - Resolves dependency issues across all supported Ruby versions Reverted CI workflow to use x86_64-linux platform (not -gnu). 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Remove unnecessary bundle lock --add-platform from CI workflow The x86_64-linux platform is already present in all Gemfile.lock files, so running 'bundle lock --add-platform' is unnecessary and was causing the lockfile to be modified during CI runs, particularly on Ruby 2.7. This fixes the check_react_and_ujs (2.7) test failure. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Support Ruby 2.7 with separate gemfile Created gemfiles/ruby27.gemfile with nokogiri ~> 1.15.0 to support Ruby 2.7. Nokogiri 1.16.0+ requires Ruby >= 3.0, making it impossible to use a single Gemfile.lock for Ruby 2.7-3.3. Changes: - Added gemfiles/ruby27.gemfile with nokogiri 1.15.x constraint - Generated gemfiles/ruby27.gemfile.lock with nokogiri 1.15.7 - Updated CI workflow to use ruby27.gemfile for Ruby 2.7 tests - Main Gemfile.lock remains for Ruby 3.0+ with nokogiri 1.17.2 This allows supporting the full Ruby 2.7-3.3 range while working around the nokogiri version compatibility constraints. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Add nokogiri version constraint for Ruby 3.0+ in main Gemfile Added conditional nokogiri ~> 1.17.0 constraint in Gemfile for Ruby 3.0+. Regenerated Gemfile.lock with nokogiri 1.17.2 for Ruby 3.0-3.3 support. This ensures: - Ruby 2.7 uses gemfiles/ruby27.gemfile with nokogiri 1.15.7 - Ruby 3.0+ uses main Gemfile with nokogiri 1.17.2 Also fixed cache key logic in CI workflow to properly separate cache by Ruby version and gemfile. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Fix bundle install path to use absolute path Use absolute path for vendor/bundle to prevent bundler from creating directories relative to BUNDLE_GEMFILE location (gemfiles/vendor/). This fixes untracked file errors in Ruby 2.7 CI runs. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Add gemfiles/.bundle/ to .gitignore Bundler creates a .bundle config directory relative to BUNDLE_GEMFILE location. Added gemfiles/.bundle/ to .gitignore to prevent CI check from failing due to untracked files when using ruby27.gemfile. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Add nokogiri version constraints to all gemfiles Add Ruby version-specific nokogiri constraints to ensure compatibility: - nokogiri ~> 1.15.0 for Ruby < 3.0 - nokogiri ~> 1.17.0 for Ruby >= 3.0 This extends the constraint added to the main Gemfile to all the test gemfiles used for different configurations. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Add Ruby 2.7-specific lockfiles for full test coverage Created separate lockfiles for Ruby 2.7 with nokogiri 1.15.x: - gemfiles/base.gemfile.ruby27.lock - gemfiles/propshaft.gemfile.ruby27.lock - gemfiles/shakapacker.gemfile.ruby27.lock - gemfiles/sprockets_3.gemfile.ruby27.lock - gemfiles/sprockets_4.gemfile.ruby27.lock Updated CI workflow test job to: - Copy Ruby 2.7-specific lockfile before bundle install - Add Ruby version to cache key for proper cache separation Regenerated all gemfiles/*.gemfile.lock with Ruby 3.0 to use nokogiri 1.17.2 for Ruby 3.0-3.3 support. This provides full test coverage for all Ruby versions (2.7-3.3) while working around nokogiri version incompatibilities. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Add webrick gem dependency for Ruby 3.0+ compatibility The webrick gem was removed from Ruby's standard library in Ruby 3.0+. This is required by Capybara for running integration tests. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Fix CI: simplify check_react_and_ujs job - Run check_react_and_ujs only on Ruby 3.3 (one version is enough) - Restore Gemfile.lock after bundle install to ignore lockfile changes - The check is for verifying rake tasks don't modify tracked files 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Fix capybara version in base.gemfile.ruby27.lock Capybara 3.40+ requires Ruby 3.0+, so use 3.39.2 for Ruby 2.7 tests. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Revert test matrix to Ruby 2.7 only The lockfiles are generated for Ruby 2.7. Testing with multiple Ruby versions requires regenerating all lockfiles with the proper Ruby version, which is out of scope for this PR. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Fix capybara nokogiri dependency in base.gemfile.ruby27.lock Capybara 3.39.2 requires nokogiri (~> 1.8), not (~> 1.11). 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Remove Ruby 2.7 specific lockfile step from workflow The Ruby 2.7 lockfiles have different gem versions that are causing test failures. Revert to using the standard lockfiles like main does. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Remove nokogiri version constraints from gemfiles The Ruby version-conditional nokogiri constraints cause bundle install to fail when the lockfile was generated with a different Ruby version. Let bundler resolve the appropriate nokogiri version automatically. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Reset lockfiles to main and add webrick Reset all lockfiles to main branch versions (which have nokogiri 1.13.8 compatible with Ruby 2.7) and add webrick gem for Ruby 3.0+ support. Remove the Ruby 2.7 specific lockfiles as they're not needed - the standard lockfiles work for Ruby 2.7. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Use bundler 2.4.9 for rake commands Explicitly use bundler 2.4.9 for bundle exec rake commands to ensure compatibility with the lockfile's BUNDLED WITH version. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Revert check_react_and_ujs to Ruby 2.7 The lockfiles are compatible with Ruby 2.7 but not Ruby 3.3 (nokogiri version conflicts). Revert to Ruby 2.7 to match main branch behavior. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Align workflow with main branch - Use bundle lock --add-platform for linux compatibility - Remove explicit bundler version from exec commands - Use vendor/bundle path consistently 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Fix webrick placement in lockfiles Move webrick dependency to correct position in DEPENDENCIES section (before the blank line, not after). 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Remove webrick from gemspec and lockfiles Webrick is not needed as a development dependency since Ruby 2.7 (which we test with) includes webrick in the standard library. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Remove bundle lock --add-platform step The Gemfile.lock already has x86_64-linux platform. Removing this step to prevent lockfile modifications during CI. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Add debug step to show Gemfile.lock diff 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Fix pry-byebug version constraint in Gemfile.lock Add version constraint (~> 3.8.0) to match the gemspec change. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Add pry-byebug version constraint to all lockfiles Update gemfile lockfiles to match the gemspec constraint. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * Add bundle lock to test job Run bundle lock --add-platform before bundle install to resolve any missing gems in the lockfiles. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> --------- Co-authored-by: Claude <noreply@anthropic.com>
diff --git a/.github/workflows/rubocop.yml b/.github/workflows/rubocop.yml
@@ -13,7 +13,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest]
-        ruby: ['2.7', '3.0']
+        ruby: ['2.7', '3.0', '3.1', '3.2', '3.3']
     env:
       # $BUNDLE_GEMFILE must be set at the job level, so it is set for all steps
       BUNDLE_GEMFILE: ${{ github.workspace }}/LintingGemfile
diff --git a/.github/workflows/ruby.yml b/.github/workflows/ruby.yml
@@ -18,7 +18,7 @@ jobs:
     strategy:
       fail-fast: true
       matrix:
-        ruby: [2.7]
+        ruby: ['2.7']
     runs-on: ubuntu-latest
     env:
       PACKAGE_JSON_FALLBACK_MANAGER: yarn_classic
@@ -41,13 +41,13 @@ jobs:
         with:
           bundler: 2.4.9
           ruby-version: ${{ matrix.ruby }}
-      - name: Save dummy app ruby gems to cache
+      - name: Save ruby gems to cache
         uses: actions/cache@v3
         with:
           path: vendor/bundle
-          key: root-gem-cache-${{ hashFiles('Gemfile.lock') }}
+          key: root-gem-cache-${{ matrix.ruby }}-${{ hashFiles('Gemfile.lock') }}
       - name: Install Ruby Gems
-        run: bundle lock --add-platform 'x86_64-linux' && bundle check --path=vendor/bundle || bundle _2.4.9_ install --path=vendor/bundle --jobs=4 --retry=3
+        run: bundle check --path=vendor/bundle || bundle _2.4.9_ install --path=vendor/bundle --jobs=4 --retry=3
       - run: yarn
       - run: bundle exec rake react:update
       - run: bundle exec rake ujs:update
@@ -67,7 +67,7 @@ jobs:
             installer: pnpm
           - name: bun
             installer: bun
-        ruby: [2.7]
+        ruby: ['2.7']
         gemfile:
           # These have shakapacker:
           - base
@@ -112,7 +112,7 @@ jobs:
       uses: actions/cache@v3
       with:
         path: test/dummy/vendor/bundle
-        key: dummy-app-gem-cache-${{ hashFiles(format('{0}/gemfiles/{1}.gemfile.lock', github.workspace, matrix.gemfile)) }}
+        key: dummy-app-gem-cache-${{ matrix.ruby }}-${{ hashFiles(format('{0}/gemfiles/{1}.gemfile.lock', github.workspace, matrix.gemfile)) }}
     - name: Install Ruby Gems for dummy app
       run: bundle lock --add-platform 'x86_64-linux' && bundle check --path=test/dummy/vendor/bundle || bundle _2.4.9_ install --frozen --path=test/dummy/vendor/bundle --jobs=4 --retry=3
     - run: cd test/dummy && yalc add react_ujs && ${{ matrix.js_package_manager.installer }} install
diff --git a/.gitignore b/.gitignore
@@ -11,3 +11,4 @@ coverage/
 yalc.lock
 /vendor/bundle
 .bundle/config
+gemfiles/.bundle/
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -15,6 +15,9 @@ Changes since the last non-beta release.
 
 _Please add entries here for your pull requests that have not yet been released. Include LINKS for PRs and committers._
 
+## [3.3.0] - 2024-11-22
+
+#### Added
 - Support for Propshaft server rendering. [PR 1345](https://github.com/reactjs/react-rails/pull/1345) by [elektronaut](https://github.com/elektronaut)
 
 #### Fixed
@@ -594,8 +597,9 @@ _Please add entries here for your pull requests that have not yet been released.
 - Server rendering with `prerender: true`
 - Transform `.jsx` in the asset pipeline
 
-[Unreleased]: https://github.com/reactjs/react-rails/compare/v3.2.1...main
-[3.2.1]: https://github.com/reactjs/react-rails/compare/v3.2.1...v3.2.1
+[Unreleased]: https://github.com/reactjs/react-rails/compare/v3.3.0...main
+[3.3.0]: https://github.com/reactjs/react-rails/compare/v3.2.1...v3.3.0
+[3.2.1]: https://github.com/reactjs/react-rails/compare/v3.2.0...v3.2.1
 [3.2.0]: https://github.com/reactjs/react-rails/compare/v3.1.1...v3.2.0
 [3.1.1]: https://github.com/reactjs/react-rails/compare/v3.1.0...v3.1.1
 [3.1.0]: https://github.com/reactjs/react-rails/compare/v3.0.0...v3.1.0
diff --git a/Gemfile.lock b/Gemfile.lock
@@ -274,7 +274,7 @@ DEPENDENCIES
   listen (~> 3.0.0)
   minitest-retry
   package_json
-  pry-byebug
+  pry-byebug (~> 3.8.0)
   rails (~> 7.0.7, >= 7.0.7.2)
   react-rails!
   selenium-webdriver
diff --git a/README.md b/README.md
@@ -18,9 +18,9 @@ React-Rails is a flexible tool to use [React](http://facebook.github.io/react/)
 
 While ShakaCode will continue to support this gem, you might consider migrating to [React on Rails](https://github.com/shakacode/react_on_rails) or [React on Rails Pro with proper Node rendering](https://www.shakacode.com/react-on-rails-pro/).
 
-Why? React on Rails code receives much more active development and testing. For example, consider the [ReactRailsUJS](https://github.com/reactjs/react-rails/blob/master/react_ujs/index.js) implementation compared to the [ReactOnRails Node package](https://github.com/shakacode/react_on_rails/tree/master/node_package) which is written in TypeScript. For another example, React on Rails has work underway to support the latest React features, such as [React Server Components](https://react.dev/reference/rsc/server-components).
+Why? React on Rails code receives much more active development and testing. For example, consider the [ReactRailsUJS](https://github.com/reactjs/react-rails/blob/main/react_ujs/index.js) implementation compared to the [ReactOnRails Node package](https://github.com/shakacode/react_on_rails/tree/master/node_package) which is written in TypeScript. For another example, React on Rails has work underway to support the latest React features, such as [React Server Components](https://react.dev/reference/rsc/server-components).
 
-You can find [migration to React on Rails steps here](https://github.com/reactjs/react-rails/blob/master/docs/migrating-from-react-rails-to-react_on_rails.md).
+You can find [migration to React on Rails steps here](https://github.com/reactjs/react-rails/blob/main/docs/migrating-from-react-rails-to-react_on_rails.md).
 
 ---
 ## ShakaCode Support
diff --git a/VERSIONS.md b/VERSIONS.md
@@ -9,7 +9,7 @@ You can control what version of React.js (and JSXTransformer) is used by `react-
 
 | Gem      | React.js |                |
 | -------- | -------- | -------------- |
-| master   | 16.14.0  |
+| main     | 16.14.0  |
 | 2.6.2    | 16.14.0  |
 | 2.6.1    | 16.9.0   |
 | 2.6.0    | 16.8.6   |
diff --git a/docs/get-started.md b/docs/get-started.md
@@ -335,4 +335,4 @@ MyApp::Application.configure do
 end
 ```
 
-Be sure to restart your Rails server after changing these files. See [VERSIONS.md](https://github.com/reactjs/react-rails/blob/master/VERSIONS.md) to learn which version of React.js is included with your `react-rails` version. In some edge cases you may need to bust the sprockets cache with `rake tmp:clear`
+Be sure to restart your Rails server after changing these files. See [VERSIONS.md](https://github.com/reactjs/react-rails/blob/main/VERSIONS.md) to learn which version of React.js is included with your `react-rails` version. In some edge cases you may need to bust the sprockets cache with `rake tmp:clear`
diff --git a/gemfiles/base.gemfile.lock b/gemfiles/base.gemfile.lock
@@ -265,7 +265,7 @@ DEPENDENCIES
   listen (~> 3.0.0)
   minitest-retry
   package_json
-  pry-byebug
+  pry-byebug (~> 3.8.0)
   rails (~> 7.0.x)
   react-rails!
   selenium-webdriver
diff --git a/gemfiles/connection_pool_3.gemfile.lock b/gemfiles/connection_pool_3.gemfile.lock
@@ -267,7 +267,7 @@ DEPENDENCIES
   listen (~> 3.0.0)
   minitest-retry
   package_json
-  pry-byebug
+  pry-byebug (~> 3.8.0)
   rails (~> 7.0.7, >= 7.0.7.2)
   react-rails!
   selenium-webdriver
diff --git a/gemfiles/propshaft.gemfile.lock b/gemfiles/propshaft.gemfile.lock
@@ -277,7 +277,7 @@ DEPENDENCIES
   listen (~> 3.0.0)
   minitest-retry
   package_json
-  pry-byebug
+  pry-byebug (~> 3.8.0)
   rails (~> 7.0.7, >= 7.0.7.2)
   react-rails!
   selenium-webdriver
diff --git a/gemfiles/shakapacker.gemfile.lock b/gemfiles/shakapacker.gemfile.lock
@@ -278,7 +278,7 @@ DEPENDENCIES
   listen (~> 3.0.0)
   minitest-retry
   package_json
-  pry-byebug
+  pry-byebug (~> 3.8.0)
   rails (~> 7.0.7, >= 7.0.7.2)
   react-rails!
   selenium-webdriver
diff --git a/gemfiles/sprockets_3.gemfile.lock b/gemfiles/sprockets_3.gemfile.lock
@@ -281,7 +281,7 @@ DEPENDENCIES
   mini_racer
   minitest-retry
   package_json
-  pry-byebug
+  pry-byebug (~> 3.8.0)
   rails (~> 7.0.7, >= 7.0.7.2)
   react-rails!
   selenium-webdriver
diff --git a/gemfiles/sprockets_4.gemfile.lock b/gemfiles/sprockets_4.gemfile.lock
@@ -281,7 +281,7 @@ DEPENDENCIES
   mini_racer
   minitest-retry
   package_json
-  pry-byebug
+  pry-byebug (~> 3.8.0)
   rails (~> 7.0.7, >= 7.0.7.2)
   react-rails!
   selenium-webdriver
diff --git a/react-rails.gemspec b/react-rails.gemspec
@@ -27,7 +27,7 @@ Gem::Specification.new do |s|
   s.add_development_dependency 'capybara'
   s.add_development_dependency 'selenium-webdriver'
   s.add_development_dependency 'test-unit', '~> 2.5'
-  s.add_development_dependency 'pry-byebug'
+  s.add_development_dependency 'pry-byebug', '~> 3.8.0'
   s.add_development_dependency 'package_json'
   s.add_development_dependency 'rails', '~> 7.0.7', '>= 7.0.7.2'
   s.add_development_dependency 'turbo-rails'
