react_on_rails 16.2.0.beta.10 → 16.2.0.beta.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: da10987e43490e2a8da60fccb2033038aa9fa6a9b5ccce9add3f9d0da795474c
-  data.tar.gz: 9e7a3a46c8bb8e0fcc57142b5a1218ea58d5155d54614038d035e2e6b39fdf47
+  metadata.gz: 94e2c46e66774ffdeb5902068d74c22daf9b2eafd08b45f1d353be5de6df24b1
+  data.tar.gz: 49e2fc58fbc4e1df4d5a0573940b5bbe2c346c7bf226f6535e80b8e1fd82e216
 SHA512:
-  metadata.gz: d9f6d5be2b5bf2437adc711b6ac77e64fb7c6540d34bdce6380e98bf919872ec59e897b87869e25221f1f461ac91b25fc146c48701eb161630cb9bea7c44c7a1
-  data.tar.gz: 5ec66977d53c808a8983277c6534e24fe966123105c4738e20995a9bb45be34a139030fe3e70ffe3251bb9961470371841bea040e558deb3fc974c154d6bdb7d
+  metadata.gz: ca050de67f3ae49a02674b0130b1b2532d090605565cff6055fa51f779741109d2415a4069ceb470a819fdcb988fab51795b278eff644c122599c484a1e6aada
+  data.tar.gz: 99e95152c8015ae37ca106f70ac64bb1b64e52c006b0fd0836f84a091bf00db014d2f09c81199b19624ddc8f6db68ea75c4d74ace02445a7d25cf7db3d79f529

data/CHANGELOG.md

@@ -23,11 +23,7 @@ After a release, please make sure to run `bundle exec rake update_changelog`. Th
 
 Changes since the last non-beta release.
 
-#### Fixed
-
-- **Duplicate Rake Task Execution**: Fixed rake tasks executing twice during asset precompilation and other rake operations. Rails Engine was loading task files twice: once via explicit `load` calls in the `rake_tasks` block (Railtie layer) and once via automatic file loading from `lib/tasks/` (Engine layer). This caused `react_on_rails:assets:webpack`, `react_on_rails:generate_packs`, and `react_on_rails:locale` tasks to run twice, significantly increasing build times. Removed explicit `load` calls and now rely on Rails Engine's standard auto-loading behavior. [PR 2052](https://github.com/shakacode/react_on_rails/pull/2052) by [justin808](https://github.com/justin808).
-
-### [v16.2.0.beta.8] - 2025-11-16
+### [v16.2.0.beta.10] - 2025-11-18
 
 #### Added
 
@@ -73,6 +69,8 @@ Changes since the last non-beta release.
 
 #### Fixed
 
+- **Duplicate Rake Task Execution**: Fixed rake tasks executing twice during asset precompilation and other rake operations. Rails Engine was loading task files twice: once via explicit `load` calls in the `rake_tasks` block (Railtie layer) and once via automatic file loading from `lib/tasks/` (Engine layer). This caused `react_on_rails:assets:webpack`, `react_on_rails:generate_packs`, and `react_on_rails:locale` tasks to run twice, significantly increasing build times. Removed explicit `load` calls and now rely on Rails Engine's standard auto-loading behavior. [PR 2052](https://github.com/shakacode/react_on_rails/pull/2052) by [justin808](https://github.com/justin808).
+
 - **Node Renderer Worker Restart**: Fixed "descriptor closed" error that occurred when the node renderer restarts while handling an in-progress request (especially streaming requests). Workers now perform graceful shutdowns: they disconnect from the cluster to stop receiving new requests, wait for active requests to complete, then shut down cleanly. A configurable `gracefulWorkerRestartTimeout` ensures workers are forcibly killed if they don't shut down in time. [PR 1970](https://github.com/shakacode/react_on_rails/pull/1970) by [AbanoubGhadban](https://github.com/AbanoubGhadban).
 
 - **Body Duplication Bug On Streaming**: Fixed a bug that happens while streaming if the node renderer connection closed after streaming some chunks to the client. [PR #1995](https://github.com/shakacode/react_on_rails/pull/1995) by [AbanoubGhadban](https://github.com/AbanoubGhadban).
@@ -1845,9 +1843,8 @@ such as:
 
 - Fix several generator-related issues.
 
-[unreleased]: https://github.com/shakacode/react_on_rails/compare/v16.2.0.beta.8...master
-[v16.2.0.beta.8]: https://github.com/shakacode/react_on_rails/compare/16.2.0.beta.4...v16.2.0.beta.8
-[16.2.0.beta.4]: https://github.com/shakacode/react_on_rails/compare/16.1.1...16.2.0.beta.4
+[unreleased]: https://github.com/shakacode/react_on_rails/compare/v16.2.0.beta.10...master
+[v16.2.0.beta.10]: https://github.com/shakacode/react_on_rails/compare/16.1.1...v16.2.0.beta.10
 [16.1.1]: https://github.com/shakacode/react_on_rails/compare/16.1.0...16.1.1
 [16.1.0]: https://github.com/shakacode/react_on_rails/compare/16.0.0...16.1.0
 [16.0.0]: https://github.com/shakacode/react_on_rails/compare/14.2.0...16.0.0

data/CLAUDE.md

@@ -2,6 +2,22 @@
 
 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
+## Project Structure Guidelines
+
+### Analysis Documents
+
+When creating analysis documents (deep dives, investigations, historical context):
+- **Location**: Place in `/analysis` directory
+- **Format**: Use Markdown (.md)
+- **Naming**: Use descriptive kebab-case names (e.g., `rake-task-duplicate-analysis.md`)
+- **Purpose**: Keep detailed analyses separate from top-level project files
+
+Examples:
+- `/analysis/rake-task-duplicate-analysis.md` - Historical analysis of duplicate rake task bug
+- `/analysis/feature-investigation.md` - Investigation of a specific feature or issue
+
+Top-level documentation (like README.md, CONTRIBUTING.md) should remain at the root.
+
 ## ⚠️ CRITICAL REQUIREMENTS
 
 **BEFORE EVERY COMMIT/PUSH:**
@@ -178,11 +194,24 @@ cd react_on_rails_pro && bundle exec rake rbs:validate
 ```
 ## Changelog
 
+**IMPORTANT: This is a monorepo with TWO separate changelogs:**
+- **Open Source**: `/CHANGELOG.md` - for react_on_rails gem and npm package
+- **Pro**: `/react_on_rails_pro/CHANGELOG.md` - for react_on_rails_pro gem and npm packages
+
+When making changes, update the **appropriate changelog(s)**:
+- Open-source features/fixes → Update `/CHANGELOG.md`
+- Pro-only features/fixes → Update `/react_on_rails_pro/CHANGELOG.md`
+- Changes affecting both → Update **BOTH** changelogs
+
+### Changelog Guidelines
+
 - **Update CHANGELOG.md for user-visible changes only** (features, bug fixes, breaking changes, deprecations, performance improvements)
 - **Do NOT add entries for**: linting, formatting, refactoring, tests, or documentation fixes
 - **Format**: `[PR 1818](https://github.com/shakacode/react_on_rails/pull/1818) by [username](https://github.com/username)` (no hash in PR number)
 - **Use `/update-changelog` command** for guided changelog updates with automatic formatting
-- **Version management**: Run `bundle exec rake update_changelog` after releases to update version headers
+- **Version management after releases**:
+  - Open source: `bundle exec rake update_changelog`
+  - Pro: `cd react_on_rails_pro && bundle exec rake update_changelog`
 - **Examples**: Run `grep -A 3 "^#### " CHANGELOG.md | head -30` to see real formatting examples
 
 ## ⚠️ FORMATTING RULES
@@ -198,12 +227,25 @@ cd react_on_rails_pro && bundle exec rake rbs:validate
 **CRITICAL**: When resolving merge conflicts, follow this exact sequence:
 
 1. **Resolve logical conflicts only** - don't worry about formatting
-2. **Add resolved files**: `git add .` (or specific files)
-3. **Auto-fix everything**: `rake autofix`
-4. **Add any formatting changes**: `git add .`
-5. **Continue rebase/merge**: `git rebase --continue` or `git commit`
+2. **VERIFY FILE PATHS** - if the conflict involved directory structure:
+   - Check if any hardcoded paths need updating
+   - Run: `grep -r "old/path" . --exclude-dir=node_modules`
+   - Pay special attention to package-scripts.yml, webpack configs, package.json
+   - **Test affected scripts:** If package-scripts.yml changed, run `yarn run prepack`
+3. **Add resolved files**: `git add .` (or specific files)
+4. **Auto-fix everything**: `rake autofix`
+5. **Add any formatting changes**: `git add .`
+6. **Continue rebase/merge**: `git rebase --continue` or `git commit`
+7. **TEST CRITICAL SCRIPTS if build configs changed:**
+   ```bash
+   yarn run prepack          # Test prepack script
+   yarn run yalc.publish     # Test yalc publish if package structure changed
+   rake run_rspec:gem        # Run relevant test suites
+   ```
 
 **❌ NEVER manually format during conflict resolution** - this causes formatting wars between tools.
+**❌ NEVER blindly accept path changes** - verify they're correct for current structure.
+**❌ NEVER skip testing after resolving conflicts in build configs** - silent failures are dangerous.
 
 ### Debugging Formatting Issues
 - Check current formatting: `yarn start format.listDifferent`
@@ -223,6 +265,18 @@ cd react_on_rails_pro && bundle exec rake rbs:validate
 - **Gem-only tests**: `rake run_rspec:gem`
 - **All tests except examples**: `rake all_but_examples`
 
+## Testing Build and Package Scripts
+
+@.claude/docs/testing-build-scripts.md
+
+## Master Branch Health Monitoring
+
+@.claude/docs/master-health-monitoring.md
+
+## Managing File Paths in Configuration Files
+
+@.claude/docs/managing-file-paths.md
+
 ## Project Architecture
 
 ### Monorepo Structure
@@ -504,6 +558,83 @@ Playwright E2E tests run automatically in CI via GitHub Actions (`.github/workfl
 - Uploads HTML reports as artifacts (available for 30 days)
 - Auto-starts Rails server before running tests
 
+## Rails Engine Development Nuances
+
+React on Rails is a **Rails Engine**, which has important implications for development:
+
+### Automatic Rake Task Loading
+
+**CRITICAL**: Rails::Engine automatically loads all `.rake` files from `lib/tasks/` directory. **DO NOT** use a `rake_tasks` block to explicitly load them, as this causes duplicate task execution.
+
+```ruby
+# ❌ WRONG - Causes duplicate execution
+module ReactOnRails
+  class Engine < ::Rails::Engine
+    rake_tasks do
+      load File.expand_path("../tasks/generate_packs.rake", __dir__)
+      load File.expand_path("../tasks/assets.rake", __dir__)
+      load File.expand_path("../tasks/locale.rake", __dir__)
+    end
+  end
+end
+
+# ✅ CORRECT - Rails::Engine loads lib/tasks/*.rake automatically
+module ReactOnRails
+  class Engine < ::Rails::Engine
+    # Rake tasks are automatically loaded from lib/tasks/*.rake by Rails::Engine
+    # No explicit loading needed
+  end
+end
+```
+
+**When to use `rake_tasks` block:**
+- Tasks are in a **non-standard location** (not `lib/tasks/`)
+- You need to **programmatically generate** tasks
+- You need to **pass context** to the tasks
+
+**Historical Context**: PR #1770 added explicit rake task loading, causing webpack builds and pack generation to run twice during `rake assets:precompile`. This was fixed in PR #2052. See `analysis/rake-task-duplicate-analysis.md` for full details.
+
+### Engine Initializers and Hooks
+
+Engines have specific initialization hooks that run at different times:
+
+```ruby
+module ReactOnRails
+  class Engine < ::Rails::Engine
+    # Runs after Rails initializes but before routes are loaded
+    config.to_prepare do
+      ReactOnRails::ServerRenderingPool.reset_pool
+    end
+
+    # Runs during Rails initialization, use for validations
+    initializer "react_on_rails.validate_version" do
+      config.after_initialize do
+        # Validation logic here
+      end
+    end
+  end
+end
+```
+
+### Engine vs Application Code
+
+- **Engine code** (`lib/react_on_rails/`): Runs in the gem context, has limited access to host application
+- **Host application code**: The Rails app that includes the gem
+- **Generators** (`lib/generators/react_on_rails/`): Run in host app context during setup
+
+### Testing Engines
+
+- **Dummy app** (`spec/dummy/`): Full Rails app for integration testing
+- **Unit tests** (`spec/react_on_rails/`): Test gem code in isolation
+- Always test both contexts: gem code alone and gem + host app integration
+
+### Common Pitfalls
+
+1. **Assuming host app structure**: Don't assume `app/javascript/` exists—it might not in older apps
+2. **Path resolution**: Use `Rails.root` for host app paths, not relative paths
+3. **Autoloading**: Engine code follows Rails autoloading rules but with a different load path
+4. **Configuration**: Engine config is separate from host app config—use `ReactOnRails.configure`
+
 ## IDE Configuration
 
 Exclude these directories to prevent IDE slowdowns:

data/CONTRIBUTING.md

@@ -426,12 +426,14 @@ For more details, see [`docs/CI_OPTIMIZATION.md`](./docs/CI_OPTIMIZATION.md).
 
 React on Rails provides PR comment commands to control CI behavior:
 
-#### `/run-skipped-ci` - Enable Full CI Mode
+#### `/run-skipped-ci` (or `/run-skipped-tests`) - Enable Full CI Mode
 
 Runs all skipped CI checks and enables full CI mode for the PR:
 
 ```
 /run-skipped-ci
+# or use the shorter alias:
+/run-skipped-tests
 ```
 
 **What it does:**

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    react_on_rails (16.2.0.beta.10)
+    react_on_rails (16.2.0.beta.11)
       addressable
       connection_pool
       execjs (~> 2.5)

data/Steepfile

@@ -28,6 +28,10 @@ target :lib do
   check "lib/react_on_rails.rb"
   check "lib/react_on_rails/configuration.rb"
   check "lib/react_on_rails/controller.rb"
+  check "lib/react_on_rails/dev/file_manager.rb"
+  check "lib/react_on_rails/dev/pack_generator.rb"
+  check "lib/react_on_rails/dev/process_manager.rb"
+  check "lib/react_on_rails/dev/server_manager.rb"
   check "lib/react_on_rails/git_utils.rb"
   check "lib/react_on_rails/helper.rb"
   check "lib/react_on_rails/packer_utils.rb"

data/analysis/rake-task-duplicate-analysis.md

@@ -0,0 +1,149 @@
+# Analysis: Why rake_tasks Block Was Added in PR #1770 and Caused Duplicate Execution
+
+## Summary
+
+In PR #1770 (commit `8f3d178` - "Generator Overhaul & Developer Experience Enhancement"), Ihab added a `rake_tasks` block to `lib/react_on_rails/engine.rb` that explicitly loaded three rake task files. This was part of a **massive generator overhaul** that introduced new rake tasks for the file-system auto-registration feature. However, this caused those tasks to execute **twice** during operations like `rake assets:precompile`, which was fixed in PR #2052.
+
+## The Problem: Double Loading of Rake Tasks
+
+### What Was Added in PR #1770 (8f3d178)
+
+```ruby
+# lib/react_on_rails/engine.rb
+module ReactOnRails
+  class Engine < ::Rails::Engine
+    # ... existing code ...
+
+    rake_tasks do
+      load File.expand_path("../tasks/generate_packs.rake", __dir__)
+      load File.expand_path("../tasks/assets.rake", __dir__)
+      load File.expand_path("../tasks/locale.rake", __dir__)
+    end
+  end
+end
+```
+
+### Why This Caused Duplicate Execution
+
+Rails Engines have **two different mechanisms** for loading rake tasks, and this code inadvertently activated both:
+
+1. **Automatic Loading (Engine Layer)**: Rails::Engine automatically loads all `.rake` files from `lib/tasks/` directory
+2. **Manual Loading (Railtie Layer)**: The `rake_tasks` block explicitly loads specific files
+
+Because the task files existed in `lib/tasks/`:
+
+- `lib/tasks/assets.rake`
+- `lib/tasks/generate_packs.rake`
+- `lib/tasks/locale.rake`
+
+They were being loaded **twice**:
+
+- Once automatically by Rails::Engine from the `lib/tasks/` directory
+- Once explicitly by the `rake_tasks` block
+
+## Why Was This Added in PR #1770?
+
+PR #1770 was a **major overhaul** with 97 files changed. Looking at the context:
+
+### The Generator Overhaul Introduced:
+
+1. **File-system auto-registration**: New feature where components auto-register under `app/javascript/src/.../ror_components`
+2. **New `react_on_rails:generate_packs` rake task**: Critical new task for the auto-registration system
+3. **Enhanced dev tooling**: New `ReactOnRails::Dev` namespace with ServerManager, ProcessManager, PackGenerator
+4. **Shakapacker as required dependency**: Made Shakapacker mandatory (removed Webpacker support)
+
+### Why the Explicit Loading Was Added:
+
+Based on the PR context and commit message, the most likely reasons:
+
+1. **Ensuring Critical Task Availability**: The `react_on_rails:generate_packs` task was brand new and absolutely critical to the file-system auto-registration feature. Ihab may have wanted to guarantee it would be loaded in all contexts.
+
+2. **Following Common Rails Engine Patterns**: The `rake_tasks` block is a well-documented pattern in Rails engines. Many gems use it explicitly, even when files are in `lib/tasks/`. Ihab likely followed this pattern as "best practice."
+
+3. **Massive PR Complexity**: With 97 files changed, this was a huge refactor. The `rake_tasks` block addition was a tiny part of the overall changes, and the duplicate loading issue was subtle enough that it wasn't caught during review.
+
+4. **Lack of Awareness About Automatic Loading**: Rails::Engine's automatic loading of `lib/tasks/*.rake` files is not as well-known as it should be. Many developers (even experienced ones) don't realize this happens automatically.
+
+5. **"Belt and Suspenders" Approach**: Given the criticality of the new auto-registration feature, Ihab may have intentionally added explicit loading as a safety measure, not realizing it would cause duplication.
+
+**The commit message doesn't mention the rake_tasks addition at all**—it focuses on generator improvements, dev experience, and component architecture. This suggests the `rake_tasks` block was added as a routine implementation detail, not something Ihab thought needed explanation.
+
+## The Impact
+
+Tasks affected by duplicate execution:
+
+- `react_on_rails:assets:webpack` - Webpack builds ran twice
+- `react_on_rails:generate_packs` - Pack generation ran twice
+- `react_on_rails:locale` - Locale file generation ran twice
+
+This meant:
+
+- **2x build times** during asset precompilation
+- **Slower CI** builds
+- **Confusing console output** showing duplicate webpack compilation messages
+- **Wasted resources** running the same expensive operations twice
+
+## The Fix (PR #2052)
+
+The fix was simple—remove the redundant `rake_tasks` block and rely solely on Rails' automatic loading:
+
+```ruby
+# lib/react_on_rails/engine.rb
+module ReactOnRails
+  class Engine < ::Rails::Engine
+    # ... existing code ...
+
+    # Rake tasks are automatically loaded from lib/tasks/*.rake by Rails::Engine
+    # No need to explicitly load them here to avoid duplicate loading
+  end
+end
+```
+
+## Key Lesson
+
+**Rails::Engine Best Practice**: If your rake task files are in `lib/tasks/`, you don't need a `rake_tasks` block. Rails will load them automatically. Only use `rake_tasks do` if:
+
+- Tasks are in a non-standard location
+- You need to programmatically generate tasks
+- You need to pass context to the tasks
+
+## Timeline
+
+- **Sep 16, 2025** (PR #1770, commit 8f3d178): Ihab adds `rake_tasks` block as part of massive Generator Overhaul (97 files changed)
+- **Nov 18, 2025** (PR #2052, commit 3f6df6be9): Justin discovers and fixes duplicate execution issue by removing the block (~2 months later)
+
+## What We Learned
+
+### For Code Reviews
+
+This incident highlights the challenge of reviewing massive PRs:
+
+- **97 files changed** made it nearly impossible to catch subtle issues
+- The `rake_tasks` addition was 6 lines in a file that wasn't the focus of the PR
+- The duplicate loading bug only manifested during asset precompilation, not during normal development
+- Smaller, focused PRs would have made this easier to catch
+
+### For Testing
+
+The duplicate execution bug was subtle:
+
+- **Didn't cause failures**—just slower builds (2x time)
+- **Hard to notice locally**—developers might not realize builds were taking twice as long
+- **Only obvious in CI**—where build times are closely monitored
+- **Needed production-like scenarios**—requires running `rake assets:precompile` to trigger
+
+### For Documentation
+
+Better documentation of Rails::Engine automatic loading would help:
+
+- Many Rails guides show `rake_tasks` blocks without mentioning automatic loading
+- The Rails Engine guide doesn't clearly state when NOT to use `rake_tasks`
+- This leads to cargo-culting of the pattern
+
+## References
+
+- **Original PR**: [#1770 - "React on Rails Generator Overhaul & Developer Experience Enhancement"](https://github.com/shakacode/react_on_rails/pull/1770)
+- **Original commit**: `8f3d178` - 97 files changed, massive refactor
+- **Fix PR**: [#2052 - "Fix duplicate rake task execution by removing explicit task loading"](https://github.com/shakacode/react_on_rails/pull/2052)
+- **Fix commit**: `3f6df6be9` - Simple 6-line removal
+- **Rails Engine documentation**: https://guides.rubyonrails.org/engines.html#rake-tasks

data/bin/ci-run-failed-specs

@@ -139,10 +139,12 @@ echo ""
 
 # Determine the working directory (check if we need to be in spec/dummy)
 WORKING_DIR="."
-if [ ${#UNIQUE_SPECS[@]} -gt 0 ] && ([[ "${UNIQUE_SPECS[0]}" == *"spec/system"* ]] || [[ "${UNIQUE_SPECS[0]}" == *"spec/helpers"* ]]); then
-  if [ -d "spec/dummy" ]; then
-    WORKING_DIR="spec/dummy"
-    echo -e "${BLUE}Running from spec/dummy directory${NC}"
+if [ ${#UNIQUE_SPECS[@]} -gt 0 ]; then
+  if [[ "${UNIQUE_SPECS[0]}" == *"spec/system"* ]] || [[ "${UNIQUE_SPECS[0]}" == *"spec/helpers"* ]]; then
+    if [ -d "spec/dummy" ]; then
+      WORKING_DIR="spec/dummy"
+      echo -e "${BLUE}Running from spec/dummy directory${NC}"
+    fi
   fi
 fi
 

data/bin/ci-switch-config

@@ -255,9 +255,10 @@ EOF
   set_node_version "20.18.1" "$VERSION_MANAGER"
 
   # Run conversion script
-  # NOTE: This uses whatever 'ruby' is in PATH after version manager updates above.
-  # The version manager may not have reloaded yet, so ensure your current Ruby is
-  # compatible with script/convert (Ruby 2.6+ should work).
+  # NOTE: This executes 'ruby' before the version manager reloads in your current shell.
+  # The script/convert file requires Ruby 2.6+ and uses basic file I/O operations.
+  # Most modern Ruby versions (2.6+) are compatible. The version manager changes above
+  # only take effect after shell reload, so this uses your current Ruby installation.
   print_header "Running script/convert to downgrade dependencies"
   cd "$PROJECT_ROOT"
   ruby script/convert

data/lib/generators/react_on_rails/base_generator.rb

@@ -101,7 +101,8 @@ module ReactOnRails
         puts "Adding Shakapacker #{ReactOnRails::PackerUtils.shakapacker_version} config"
         base_path = "base/base/"
         config = "config/shakapacker.yml"
-        copy_file("#{base_path}#{config}", config)
+        # Use template to enable version-aware configuration
+        template("#{base_path}#{config}.tt", config)
         configure_rspack_in_shakapacker if options.rspack?
       end
 

data/lib/generators/react_on_rails/generator_helper.rb

@@ -95,4 +95,33 @@ module GeneratorHelper
   def component_extension(options)
     options.typescript? ? "tsx" : "jsx"
   end
+
+  # Check if Shakapacker 9.0 or higher is available
+  # Returns true if Shakapacker >= 9.0, false otherwise
+  #
+  # This method is used during code generation to determine which configuration
+  # patterns to use in generated files (e.g., config.privateOutputPath vs hardcoded paths).
+  #
+  # @return [Boolean] true if Shakapacker 9.0+ is available or likely to be installed
+  #
+  # @note Default behavior: Returns true when Shakapacker is not yet installed
+  #   Rationale: During fresh installations, we optimistically assume users will install
+  #   the latest Shakapacker version. This ensures new projects get best-practice configs.
+  #   If users later install an older version, the generated webpack config includes
+  #   fallback logic (e.g., `config.privateOutputPath || hardcodedPath`) that prevents
+  #   breakage, and validation warnings guide them to fix any misconfigurations.
+  def shakapacker_version_9_or_higher?
+    return @shakapacker_version_9_or_higher if defined?(@shakapacker_version_9_or_higher)
+
+    @shakapacker_version_9_or_higher = begin
+      # If Shakapacker is not available yet (fresh install), default to true
+      # since we're likely installing the latest version
+      return true unless defined?(ReactOnRails::PackerUtils)
+
+      ReactOnRails::PackerUtils.shakapacker_version_requirement_met?("9.0.0")
+    rescue StandardError
+      # If we can't determine version, assume latest
+      true
+    end
+  end
 end

data/lib/generators/react_on_rails/js_dependency_manager.rb

@@ -123,14 +123,36 @@ module ReactOnRails
       end
 
       def add_react_on_rails_package
-        # Use exact version match between gem and npm package for stable releases
-        # For pre-release versions (e.g., 16.1.0-rc.1), use latest to avoid installing
-        # a version that may not exist in the npm registry
-        major_minor_patch_only = /\A\d+\.\d+\.\d+\z/
-        react_on_rails_pkg = if ReactOnRails::VERSION.match?(major_minor_patch_only)
-                               "react-on-rails@#{ReactOnRails::VERSION}"
+        # Use exact version match between gem and npm package for all versions including pre-releases
+        # Ruby gem versions use dots (16.2.0.beta.10) but npm requires hyphens (16.2.0-beta.10)
+        # This method converts between the two formats.
+        #
+        # The regex matches:
+        # - Stable: 16.2.0
+        # - Beta (Ruby): 16.2.0.beta.10 or (npm): 16.2.0-beta.10
+        # - RC (Ruby): 16.1.0.rc.1 or (npm): 16.1.0-rc.1
+        # - Alpha (Ruby): 16.0.0.alpha.5 or (npm): 16.0.0-alpha.5
+        # This ensures beta/rc versions use the exact version instead of "latest" which would
+        # install the latest stable release and cause version mismatches.
+
+        # Accept both dot and hyphen separators for pre-release versions
+        version_with_optional_prerelease = /\A(\d+\.\d+\.\d+)([-.]([a-zA-Z0-9.]+))?\z/
+
+        react_on_rails_pkg = if (match = ReactOnRails::VERSION.match(version_with_optional_prerelease))
+                               base_version = match[1]
+                               prerelease = match[3]
+
+                               # Convert Ruby gem format (dot) to npm semver format (hyphen)
+                               npm_version = if prerelease
+                                               "#{base_version}-#{prerelease}"
+                                             else
+                                               base_version
+                                             end
+
+                               "react-on-rails@#{npm_version}"
                              else
-                               puts "Adding the latest react-on-rails NPM module. " \
+                               puts "WARNING: Unrecognized version format #{ReactOnRails::VERSION}. " \
+                                    "Adding the latest react-on-rails NPM module. " \
                                     "Double check this is correct in package.json"
                                "react-on-rails"
                              end

data/lib/generators/react_on_rails/templates/base/base/config/initializers/react_on_rails.rb.tt

@@ -12,6 +12,25 @@ ReactOnRails.configure do |config|
   # Set to "" if you're not using server rendering
   config.server_bundle_js_file = "server-bundle.js"
 
+  # ⚠️ RECOMMENDED: Use Shakapacker 9.0+ private_output_path instead
+  #
+  # If using Shakapacker 9.0+, add to config/shakapacker.yml:
+  #   private_output_path: ssr-generated
+  #
+  # React on Rails will auto-detect this value, eliminating the need to set it here.
+  # This keeps your webpack and Rails configs in sync automatically.
+  #
+  # For older Shakapacker versions or custom setups, manually configure:
+  # config.server_bundle_output_path = "ssr-generated"
+  #
+  # The path is relative to Rails.root and should point to a private directory
+  # (outside of public/) for security. Run 'rails react_on_rails:doctor' to verify.
+
+  # Enforce that server bundles are only loaded from private (non-public) directories.
+  # When true, server bundles will only be loaded from the configured server_bundle_output_path.
+  # This is recommended for production to prevent server-side code from being exposed.
+  config.enforce_private_server_bundles = true
+
   ################################################################################
   # Test Configuration (Optional)
   ################################################################################

data/lib/generators/react_on_rails/templates/base/base/config/{shakapacker.yml → shakapacker.yml.tt}

@@ -29,6 +29,15 @@ default: &default
   # Location for manifest.json, defaults to {public_output_path}/manifest.json if unset
   # manifest_path: public/packs/manifest.json
 
+  # Location for private server-side bundles (e.g., for SSR)
+  # These bundles are not served publicly, unlike public_output_path
+  # Shakapacker 9.0+ feature - automatically detected by React on Rails
+<% if shakapacker_version_9_or_higher? -%>
+  private_output_path: ssr-generated
+<% else -%>
+  # private_output_path: ssr-generated  # Uncomment to enable (requires Shakapacker 9.0+)
+<% end -%>
+
   # Additional paths webpack should look up modules
   # ['app/assets', 'engine/foo/app/assets']
   additional_paths: []

data/lib/generators/react_on_rails/templates/base/base/config/webpack/serverWebpackConfig.js.tt

@@ -44,19 +44,53 @@ const configureServer = () => {
   };
   serverWebpackConfig.plugins.unshift(new bundler.optimize.LimitChunkCountPlugin({ maxChunks: 1 }));
 
-  // Custom output for the server-bundle that matches the config in
-  // config/initializers/react_on_rails.rb
-  // Server bundles are output to a private directory (not public) for security
+  // Custom output for the server-bundle
+<% if shakapacker_version_9_or_higher? -%>
+  // Using Shakapacker 9.0+ privateOutputPath for automatic sync with shakapacker.yml
+  // This eliminates manual path configuration and keeps configs in sync.
+  // Falls back to hardcoded path if private_output_path is not configured.
+  const serverBundleOutputPath = config.privateOutputPath ||
+    require('path').resolve(__dirname, '../../ssr-generated');
+<% else -%>
+  // Using hardcoded path (Shakapacker < 9.0)
+  // For Shakapacker 9.0+, consider using config.privateOutputPath instead
+  // to automatically sync with shakapacker.yml private_output_path.
+  const serverBundleOutputPath = require('path').resolve(__dirname, '../../ssr-generated');
+<% end -%>
+
   serverWebpackConfig.output = {
     filename: 'server-bundle.js',
     globalObject: 'this',
     // If using the React on Rails Pro node server renderer, uncomment the next line
     // libraryTarget: 'commonjs2',
-    path: require('path').resolve(__dirname, '../../ssr-generated'),
+    path: serverBundleOutputPath,
     // No publicPath needed since server bundles are not served via web
     // https://webpack.js.org/configuration/output/#outputglobalobject
   };
 
+  // Validate server bundle output path configuration
+<% if shakapacker_version_9_or_higher? -%>
+  // For Shakapacker 9.0+, verify privateOutputPath is configured in shakapacker.yml
+  if (!config.privateOutputPath) {
+    console.warn('⚠️  Shakapacker 9.0+ detected but private_output_path not configured in shakapacker.yml');
+    console.warn('   Add to config/shakapacker.yml:');
+    console.warn('     private_output_path: ssr-generated');
+    console.warn('   Run: rails react_on_rails:doctor to validate your configuration');
+  }
+<% else -%>
+  // For Shakapacker < 9.0, verify hardcoded path syncs with Rails config
+  // 1. Ensure config/initializers/react_on_rails.rb has: config.server_bundle_output_path = "ssr-generated"
+  // 2. Run: rails react_on_rails:doctor to verify configuration
+  const fs = require('fs');
+  if (!fs.existsSync(serverBundleOutputPath)) {
+    console.warn(`⚠️  Server bundle output directory does not exist: ${serverBundleOutputPath}`);
+    console.warn('   It will be created during build, but ensure React on Rails is configured:');
+    console.warn('   config.server_bundle_output_path = "ssr-generated" in config/initializers/react_on_rails.rb');
+    console.warn('   Run: rails react_on_rails:doctor to validate your configuration');
+  }
+<% end -%>
+
+
   // Don't hash the server bundle b/c would conflict with the client manifest
   // And no need for the MiniCssExtractPlugin
   serverWebpackConfig.plugins = serverWebpackConfig.plugins.filter(

data/lib/react_on_rails/configuration.rb

@@ -1,5 +1,23 @@
 # frozen_string_literal: true
 
+require "active_support/core_ext/enumerable"
+require "active_support/core_ext/object/blank"
+
+# Polyfill for compact_blank (added in Rails 6.1) to support Rails 5.2-6.0
+unless [].respond_to?(:compact_blank)
+  module Enumerable
+    def compact_blank
+      reject(&:blank?)
+    end
+  end
+
+  class Array
+    def compact_blank
+      reject(&:blank?)
+    end
+  end
+end
+
 # rubocop:disable Metrics/ClassLength
 
 module ReactOnRails
@@ -10,6 +28,7 @@ module ReactOnRails
 
   DEFAULT_GENERATED_ASSETS_DIR = File.join(%w[public webpack], Rails.env).freeze
   DEFAULT_COMPONENT_REGISTRY_TIMEOUT = 5000
+  DEFAULT_SERVER_BUNDLE_OUTPUT_PATH = "ssr-generated"
 
   def self.configuration
     @configuration ||= Configuration.new(
@@ -46,7 +65,7 @@ module ReactOnRails
       # Set to 0 to disable the timeout and wait indefinitely for component registration.
       component_registry_timeout: DEFAULT_COMPONENT_REGISTRY_TIMEOUT,
       generated_component_packs_loading_strategy: nil,
-      server_bundle_output_path: "ssr-generated",
+      server_bundle_output_path: DEFAULT_SERVER_BUNDLE_OUTPUT_PATH,
       enforce_private_server_bundles: false
     )
   end
@@ -184,6 +203,7 @@ module ReactOnRails
       check_component_registry_timeout
       validate_generated_component_packs_loading_strategy
       validate_enforce_private_server_bundles
+      auto_detect_server_bundle_path_from_shakapacker
     end
 
     private
@@ -257,6 +277,57 @@ module ReactOnRails
                                  "the public directory. Please set it to a directory outside of public."
     end
 
+    # Auto-detect server_bundle_output_path from Shakapacker 9.0+ private_output_path
+    # Checks if user explicitly set a value and warns them to use auto-detection instead
+    def auto_detect_server_bundle_path_from_shakapacker
+      # Skip if Shakapacker is not available
+      return unless defined?(::Shakapacker)
+
+      # Check if Shakapacker config has private_output_path method (9.0+)
+      return unless ::Shakapacker.config.respond_to?(:private_output_path)
+
+      # Get the private_output_path from Shakapacker
+      private_path = ::Shakapacker.config.private_output_path
+      return unless private_path
+
+      relative_path = ReactOnRails::Utils.normalize_to_relative_path(private_path)
+
+      # Check if user explicitly configured server_bundle_output_path
+      if server_bundle_output_path != ReactOnRails::DEFAULT_SERVER_BUNDLE_OUTPUT_PATH
+        warn_about_explicit_configuration(relative_path)
+        return
+      end
+
+      apply_shakapacker_private_output_path(relative_path)
+    rescue StandardError => e
+      # Fail gracefully - if auto-detection fails, keep the default
+      Rails.logger&.debug("ReactOnRails: Could not auto-detect server bundle path from " \
+                          "Shakapacker: #{e.message}")
+    end
+
+    def warn_about_explicit_configuration(shakapacker_path)
+      # Normalize both paths for comparison
+      normalized_config = server_bundle_output_path.to_s.chomp("/")
+      normalized_shakapacker = shakapacker_path.to_s.chomp("/")
+
+      # Only warn if there's a mismatch
+      return if normalized_config == normalized_shakapacker
+
+      Rails.logger&.warn(
+        "ReactOnRails: server_bundle_output_path is explicitly set to '#{server_bundle_output_path}' " \
+        "but shakapacker.yml private_output_path is '#{shakapacker_path}'. " \
+        "Consider removing server_bundle_output_path from your React on Rails initializer " \
+        "to use the auto-detected value from shakapacker.yml."
+      )
+    end
+
+    def apply_shakapacker_private_output_path(relative_path)
+      self.server_bundle_output_path = relative_path
+
+      Rails.logger&.debug("ReactOnRails: Auto-detected server_bundle_output_path from " \
+                          "shakapacker.yml private_output_path: '#{relative_path}'")
+    end
+
     def check_minimum_shakapacker_version
       ReactOnRails::PackerUtils.raise_shakapacker_version_incompatible_for_basic_pack_generation unless
         ReactOnRails::PackerUtils.supports_basic_pack_generation?
@@ -360,13 +431,16 @@ module ReactOnRails
     def ensure_webpack_generated_files_exists
       return unless webpack_generated_files.empty?
 
-      self.webpack_generated_files = [
-        "manifest.json",
-        server_bundle_js_file,
-        rsc_bundle_js_file,
-        react_client_manifest_file,
-        react_server_client_manifest_file
-      ].compact_blank
+      files = ["manifest.json", server_bundle_js_file]
+
+      if ReactOnRails::Utils.react_on_rails_pro?
+        pro_config = ReactOnRailsPro.configuration
+        files << pro_config.rsc_bundle_js_file
+        files << pro_config.react_client_manifest_file
+        files << pro_config.react_server_client_manifest_file
+      end
+
+      self.webpack_generated_files = files.compact_blank
     end
 
     def configure_skip_display_none_deprecation

data/lib/react_on_rails/dev/pack_generator.rb

@@ -2,6 +2,7 @@
 
 require "English"
 require "stringio"
+require_relative "../packer_utils"
 
 module ReactOnRails
   module Dev

data/lib/react_on_rails/dev/server_manager.rb

@@ -3,6 +3,7 @@
 require "English"
 require "open3"
 require "rainbow"
+require_relative "../packer_utils"
 
 module ReactOnRails
   module Dev

data/lib/react_on_rails/doctor.rb

@@ -667,6 +667,7 @@ module ReactOnRails
       end
     end
 
+    # rubocop:disable Metrics/CyclomaticComplexity
     def analyze_server_rendering_config(content)
       checker.add_info("\n🖥️  Server Rendering:")
 
@@ -678,6 +679,19 @@ module ReactOnRails
         checker.add_info("  server_bundle_js_file: server-bundle.js (default)")
       end
 
+      # Server bundle output path
+      server_bundle_path_match = content.match(/config\.server_bundle_output_path\s*=\s*["']([^"']+)["']/)
+      default_path = ReactOnRails::DEFAULT_SERVER_BUNDLE_OUTPUT_PATH
+      rails_bundle_path = server_bundle_path_match ? server_bundle_path_match[1] : default_path
+      checker.add_info("  server_bundle_output_path: #{rails_bundle_path}")
+
+      # Enforce private server bundles
+      enforce_private_match = content.match(/config\.enforce_private_server_bundles\s*=\s*([^\s\n,]+)/)
+      checker.add_info("  enforce_private_server_bundles: #{enforce_private_match[1]}") if enforce_private_match
+
+      # Check Shakapacker integration and provide recommendations
+      check_shakapacker_private_output_path(rails_bundle_path)
+
       # RSC bundle file (Pro feature)
       rsc_bundle_match = content.match(/config\.rsc_bundle_js_file\s*=\s*["']([^"']+)["']/)
       if rsc_bundle_match
@@ -702,9 +716,9 @@ module ReactOnRails
 
       checker.add_info("  raise_on_prerender_error: #{raise_on_error_match[1]}")
     end
-    # rubocop:enable Metrics/AbcSize
+    # rubocop:enable Metrics/CyclomaticComplexity
 
-    # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity
+    # rubocop:disable Metrics/CyclomaticComplexity
     def analyze_performance_config(content)
       checker.add_info("\n⚡ Performance & Loading:")
 
@@ -1387,9 +1401,85 @@ module ReactOnRails
     end
 
     def log_debug(message)
-      return unless defined?(Rails.logger) && Rails.logger
+      Rails.logger&.debug(message)
+    end
+
+    # Check Shakapacker private_output_path integration and provide recommendations
+    def check_shakapacker_private_output_path(rails_bundle_path)
+      return report_no_shakapacker unless defined?(::Shakapacker)
+      return report_upgrade_shakapacker unless ::Shakapacker.config.respond_to?(:private_output_path)
+
+      check_shakapacker_9_private_output_path(rails_bundle_path)
+    rescue StandardError => e
+      checker.add_info("\n  ℹ️  Could not check Shakapacker config: #{e.message}")
+    end
+
+    def report_no_shakapacker
+      checker.add_info("\n  ℹ️  Shakapacker not detected - using manual configuration")
+    end
+
+    def report_upgrade_shakapacker
+      checker.add_info(<<~MSG.strip)
+        \n  💡 Recommendation: Upgrade to Shakapacker 9.0+
+
+        Shakapacker 9.0+ adds 'private_output_path' in shakapacker.yml for server bundles.
+        This eliminates the need to configure server_bundle_output_path separately.
+
+        Benefits:
+        - Single source of truth in shakapacker.yml
+        - Automatic detection by React on Rails
+        - No configuration duplication
+      MSG
+    end
+
+    def check_shakapacker_9_private_output_path(rails_bundle_path)
+      private_path = ::Shakapacker.config.private_output_path
+
+      if private_path
+        report_shakapacker_path_status(private_path, rails_bundle_path)
+      else
+        report_configure_private_output_path(rails_bundle_path)
+      end
+    end
+
+    def report_shakapacker_path_status(private_path, rails_bundle_path)
+      relative_path = ReactOnRails::Utils.normalize_to_relative_path(private_path)
+      # Normalize both paths for comparison (remove trailing slashes)
+      normalized_relative = relative_path.to_s.chomp("/")
+      normalized_rails = rails_bundle_path.to_s.chomp("/")
+
+      if normalized_relative == normalized_rails
+        checker.add_success("\n  ✅ Using Shakapacker 9.0+ private_output_path: '#{relative_path}'")
+        checker.add_info("     Auto-detected from shakapacker.yml - no manual config needed")
+      else
+        report_configuration_mismatch(relative_path, rails_bundle_path)
+      end
+    end
+
+    def report_configuration_mismatch(relative_path, rails_bundle_path)
+      checker.add_warning(<<~MSG.strip)
+        \n  ⚠️  Configuration mismatch detected!
+
+        Shakapacker private_output_path: '#{relative_path}'
+        React on Rails server_bundle_output_path: '#{rails_bundle_path}'
+
+        Recommendation: Remove server_bundle_output_path from your React on Rails
+        initializer and let it auto-detect from shakapacker.yml private_output_path.
+      MSG
+    end
+
+    def report_configure_private_output_path(rails_bundle_path)
+      checker.add_info(<<~MSG.strip)
+        \n  💡 Recommendation: Configure private_output_path in shakapacker.yml
+
+        Add to config/shakapacker.yml:
+          private_output_path: #{rails_bundle_path}
 
-      Rails.logger.debug(message)
+        This will:
+        - Keep webpack and Rails configs in sync automatically
+        - Enable auto-detection by React on Rails
+        - Serve as single source of truth for server bundle location
+      MSG
     end
   end
   # rubocop:enable Metrics/ClassLength

data/lib/react_on_rails/system_checker.rb

@@ -213,17 +213,20 @@ module ReactOnRails
 
         return unless npm_version && defined?(ReactOnRails::VERSION)
 
-        # Clean version strings for comparison (remove ^, ~, =, etc.)
-        clean_npm_version = npm_version.gsub(/[^0-9.]/, "")
+        # Normalize NPM version format to Ruby gem format for comparison
+        # Uses existing VersionSyntaxConverter to handle dash/dot differences
+        # (e.g., "16.2.0-beta.10" → "16.2.0.beta.10")
+        converter = ReactOnRails::VersionSyntaxConverter.new
+        normalized_npm_version = converter.npm_to_rubygem(npm_version)
         gem_version = ReactOnRails::VERSION
 
-        if clean_npm_version == gem_version
+        if normalized_npm_version == gem_version
           add_success("✅ React on Rails gem and NPM package versions match (#{gem_version})")
           check_version_patterns(npm_version, gem_version)
         else
           # Check for major version differences
           gem_major = gem_version.split(".")[0].to_i
-          npm_major = clean_npm_version.split(".")[0].to_i
+          npm_major = normalized_npm_version.split(".")[0].to_i
 
           if gem_major != npm_major # rubocop:disable Style/NegatedIfElseCondition
             add_error(<<~MSG.strip)

data/lib/react_on_rails/utils.rb

@@ -443,6 +443,60 @@ module ReactOnRails
       end
     end
 
+    # Converts an absolute path (String or Pathname) to a path relative to Rails.root.
+    # If the path is already relative or doesn't contain Rails.root, returns it as-is.
+    #
+    # This method is used to normalize paths from Shakapacker's privateOutputPath (which is
+    # absolute) to relative paths suitable for React on Rails configuration.
+    #
+    # Note: Absolute paths that don't start with Rails.root are intentionally passed through
+    # unchanged. While there's no known use case for server bundles outside Rails.root,
+    # this behavior preserves the original path for debugging and error messages.
+    #
+    # @param path [String, Pathname] The path to normalize
+    # @return [String, nil] The relative path as a string, or nil if path is nil
+    #
+    # @example Converting absolute paths within Rails.root
+    #   # Assuming Rails.root is "/app"
+    #   normalize_to_relative_path("/app/ssr-generated") # => "ssr-generated"
+    #   normalize_to_relative_path("/app/foo/bar")       # => "foo/bar"
+    #
+    # @example Already relative paths pass through
+    #   normalize_to_relative_path("ssr-generated")      # => "ssr-generated"
+    #   normalize_to_relative_path("./ssr-generated")    # => "./ssr-generated"
+    #
+    # @example Absolute paths outside Rails.root (edge case)
+    #   normalize_to_relative_path("/other/path/bundles") # => "/other/path/bundles"
+    # rubocop:disable Metrics/CyclomaticComplexity
+    def self.normalize_to_relative_path(path)
+      return nil if path.nil?
+
+      path_str = path.to_s
+      rails_root_str = Rails.root.to_s.chomp("/")
+
+      # Treat as "inside Rails.root" only for exact match or a subdirectory
+      inside_rails_root = rails_root_str.present? &&
+                          (path_str == rails_root_str || path_str.start_with?("#{rails_root_str}/"))
+
+      # If path is within Rails.root, remove that prefix
+      if inside_rails_root
+        # Remove Rails.root and any leading slash
+        path_str.sub(%r{^#{Regexp.escape(rails_root_str)}/?}, "")
+      else
+        # Path is already relative or outside Rails.root
+        # Warn if it's an absolute path outside Rails.root (edge case)
+        if path_str.start_with?("/") && !inside_rails_root
+          Rails.logger&.warn(
+            "ReactOnRails: Detected absolute path outside Rails.root: '#{path_str}'. " \
+            "Server bundles are typically stored within Rails.root. " \
+            "Verify this is intentional."
+          )
+        end
+        path_str
+      end
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity
+
     def self.default_troubleshooting_section
       <<~DEFAULT
         📞 Get Help & Support:

data/lib/react_on_rails/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ReactOnRails
-  VERSION = "16.2.0.beta.10"
+  VERSION = "16.2.0.beta.11"
 end

data/react_on_rails_pro/Gemfile.lock

@@ -9,7 +9,7 @@ GIT
 PATH
   remote: ..
   specs:
-    react_on_rails (16.2.0.beta.10)
+    react_on_rails (16.2.0.beta.11)
       addressable
       connection_pool
       execjs (~> 2.5)
@@ -20,7 +20,7 @@ PATH
 PATH
   remote: .
   specs:
-    react_on_rails_pro (16.2.0.beta.10)
+    react_on_rails_pro (16.2.0.beta.11)
       addressable
       async (>= 2.6)
       connection_pool
@@ -28,7 +28,7 @@ PATH
       httpx (~> 1.5)
       jwt (~> 2.7)
       rainbow
-      react_on_rails (= 16.2.0.beta.10)
+      react_on_rails (= 16.2.0.beta.11)
 
 GEM
   remote: https://rubygems.org/

data/react_on_rails_pro/lib/react_on_rails_pro/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module ReactOnRailsPro
-  VERSION = "16.2.0.beta.10"
+  VERSION = "16.2.0.beta.11"
   PROTOCOL_VERSION = "2.0.0"
 end

data/react_on_rails_pro/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-on-rails-pro-node-renderer",
-  "version": "16.2.0-beta.10",
+  "version": "16.2.0-beta.11",
   "protocolVersion": "2.0.0",
   "description": "react-on-rails-pro JavaScript for react_on_rails_pro Ruby gem",
   "exports": {

data/react_on_rails_pro/spec/dummy/Gemfile.lock

@@ -9,7 +9,7 @@ GIT
 PATH
   remote: ../../..
   specs:
-    react_on_rails (16.2.0.beta.10)
+    react_on_rails (16.2.0.beta.11)
       addressable
       connection_pool
       execjs (~> 2.5)
@@ -20,7 +20,7 @@ PATH
 PATH
   remote: ../..
   specs:
-    react_on_rails_pro (16.2.0.beta.10)
+    react_on_rails_pro (16.2.0.beta.11)
       addressable
       async (>= 2.6)
       connection_pool
@@ -28,7 +28,7 @@ PATH
       httpx (~> 1.5)
       jwt (~> 2.7)
       rainbow
-      react_on_rails (= 16.2.0.beta.10)
+      react_on_rails (= 16.2.0.beta.11)
 
 GEM
   remote: https://rubygems.org/

data/sig/react_on_rails/dev/file_manager.rbs

@@ -0,0 +1,15 @@
+module ReactOnRails
+  module Dev
+    class FileManager
+      def self.cleanup_stale_files: () -> bool
+
+      private
+
+      def self.cleanup_overmind_sockets: () -> bool
+      def self.cleanup_rails_pid_file: () -> bool
+      def self.overmind_running?: () -> bool
+      def self.process_running?: (Integer) -> bool
+      def self.remove_file_if_exists: (String, String) -> bool
+    end
+  end
+end

data/sig/react_on_rails/dev/pack_generator.rbs

@@ -0,0 +1,19 @@
+module ReactOnRails
+  module Dev
+    class PackGenerator
+      def self.generate: (?verbose: bool) -> void
+
+      private
+
+      def self.run_pack_generation: (?silent: bool) -> bool
+      def self.should_run_directly?: () -> bool
+      def self.rails_available?: () -> bool
+      def self.run_rake_task_directly: (?silent: bool) -> bool
+      def self.load_rake_tasks: () -> void
+      def self.prepare_rake_task: () -> untyped
+      def self.capture_output: (bool) { () -> bool } -> bool
+      def self.handle_rake_error: (Exception, bool) -> void
+      def self.run_via_bundle_exec: (?silent: bool) -> (bool | nil)
+    end
+  end
+end

data/sig/react_on_rails/dev/process_manager.rbs

@@ -0,0 +1,22 @@
+module ReactOnRails
+  module Dev
+    class ProcessManager
+      VERSION_CHECK_TIMEOUT: Integer
+
+      def self.installed?: (String) -> bool
+      def self.ensure_procfile: (String) -> void
+      def self.run_with_process_manager: (String) -> void
+
+      private
+
+      def self.installed_in_current_context?: (String) -> bool
+      def self.version_flags_for: (String) -> Array[String]
+      def self.run_process_if_available: (String, Array[String]) -> bool
+      def self.run_process_outside_bundle: (String, Array[String]) -> bool
+      def self.process_available_in_system?: (String) -> bool
+      def self.with_unbundled_context: () { () -> untyped } -> untyped
+      def self.show_process_manager_installation_help: () -> void
+      def self.valid_procfile_path?: (String) -> bool
+    end
+  end
+end

data/sig/react_on_rails/dev/server_manager.rbs

@@ -0,0 +1,39 @@
+module ReactOnRails
+  module Dev
+    class ServerManager
+      type mode = :development | :production_like | :static | :hmr
+
+      def self.start: (mode, String?, ?verbose: bool, ?route: String?, ?rails_env: String?) -> void
+      def self.kill_processes: () -> void
+      def self.development_processes: () -> Hash[String, String]
+      def self.kill_running_processes: () -> bool
+      def self.find_process_pids: (String) -> Array[Integer]
+      def self.terminate_processes: (Array[Integer]) -> void
+      def self.kill_port_processes: (Array[Integer]) -> bool
+      def self.find_port_pids: (Integer) -> Array[Integer]
+      def self.cleanup_socket_files: () -> bool
+      def self.print_kill_summary: (bool) -> void
+      def self.show_help: () -> void
+      def self.run_from_command_line: (?Array[String]) -> void
+
+      private
+
+      def self.help_usage: () -> String
+      def self.help_commands: () -> String
+      def self.help_options: () -> String
+      def self.help_customization: () -> String
+      def self.help_mode_details: () -> String
+      def self.help_troubleshooting: () -> String
+      def self.run_production_like: (?_verbose: bool, ?route: String?, ?rails_env: String?) -> void
+      def self.run_static_development: (String, ?verbose: bool, ?route: String?) -> void
+      def self.run_development: (String, ?verbose: bool, ?route: String?) -> void
+      def self.print_server_info: (String, Array[String], ?Integer, ?route: String?) -> void
+      def self.print_procfile_info: (String, ?route: String?) -> void
+      def self.procfile_port: (String) -> Integer
+      def self.box_border: (Integer) -> String
+      def self.box_bottom: (Integer) -> String
+      def self.box_empty_line: (Integer) -> String
+      def self.format_box_line: (String, Integer) -> String
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: react_on_rails
 version: !ruby/object:Gem::Version
-  version: 16.2.0.beta.10
+  version: 16.2.0.beta.11
 platform: ruby
 authors:
 - Justin Gordon
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-11-19 00:00:00.000000000 Z
+date: 2025-11-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -140,6 +140,7 @@ files:
 - Steepfile
 - TODO.md
 - WARP.md
+- analysis/rake-task-duplicate-analysis.md
 - app/helpers/react_on_rails_helper.rb
 - bin/ci-local
 - bin/ci-rerun-failures
@@ -191,7 +192,7 @@ files:
 - lib/generators/react_on_rails/templates/base/base/bin/shakapacker-precompile-hook
 - lib/generators/react_on_rails/templates/base/base/bin/switch-bundler
 - lib/generators/react_on_rails/templates/base/base/config/initializers/react_on_rails.rb.tt
-- lib/generators/react_on_rails/templates/base/base/config/shakapacker.yml
+- lib/generators/react_on_rails/templates/base/base/config/shakapacker.yml.tt
 - lib/generators/react_on_rails/templates/base/base/config/webpack/clientWebpackConfig.js.tt
 - lib/generators/react_on_rails/templates/base/base/config/webpack/commonWebpackConfig.js.tt
 - lib/generators/react_on_rails/templates/base/base/config/webpack/development.js.tt
@@ -974,6 +975,10 @@ files:
 - sig/react_on_rails.rbs
 - sig/react_on_rails/configuration.rbs
 - sig/react_on_rails/controller.rbs
+- sig/react_on_rails/dev/file_manager.rbs
+- sig/react_on_rails/dev/pack_generator.rbs
+- sig/react_on_rails/dev/process_manager.rbs
+- sig/react_on_rails/dev/server_manager.rbs
 - sig/react_on_rails/error.rbs
 - sig/react_on_rails/generators/js_dependency_manager.rbs
 - sig/react_on_rails/git_utils.rbs