react_on_rails 16.2.0.beta.4 → 16.2.0.beta.10

data/lib/generators/react_on_rails/install_generator.rb

@@ -4,12 +4,14 @@ require "rails/generators"
 require "json"
 require_relative "generator_helper"
 require_relative "generator_messages"
+require_relative "js_dependency_manager"
 
 module ReactOnRails
   module Generators
     # rubocop:disable Metrics/ClassLength
     class InstallGenerator < Rails::Generators::Base
       include GeneratorHelper
+      include JsDependencyManager
 
       # fetch USAGE file for details generator description
       source_root(File.expand_path(__dir__))
@@ -113,10 +115,7 @@ module ReactOnRails
       end
 
       def setup_react_dependencies
-        @added_dependencies_to_package_json ||= false
-        @ran_direct_installs ||= false
-        add_js_dependencies
-        install_js_dependencies if @added_dependencies_to_package_json && !@ran_direct_installs
+        setup_js_dependencies
       end
 
       # NOTE: other requirements for existing files such as .gitignore or application.
@@ -366,29 +365,8 @@ module ReactOnRails
 
       def install_typescript_dependencies
         puts Rainbow("📝 Installing TypeScript dependencies...").yellow
-
-        # Install TypeScript and React type definitions
-        typescript_packages = %w[
-          typescript
-          @types/react
-          @types/react-dom
-          @babel/preset-typescript
-        ]
-
-        # Try using GeneratorHelper first (package manager agnostic)
-        return if add_npm_dependencies(typescript_packages, dev: true)
-
-        # Fallback to npm if GeneratorHelper fails
-        success = system("npm", "install", "--save-dev", *typescript_packages)
-        return if success
-
-        warning = <<~MSG.strip
-          ⚠️  Failed to install TypeScript dependencies automatically.
-
-          Please run manually:
-              npm install --save-dev #{typescript_packages.join(' ')}
-        MSG
-        GeneratorMessages.add_warning(warning)
+        # Delegate to shared module for consistent dependency management
+        add_typescript_dependencies
       end
 
       def create_css_module_types
@@ -450,159 +428,6 @@ module ReactOnRails
         puts Rainbow("✅ Created tsconfig.json").green
       end
 
-      def add_js_dependencies
-        add_react_on_rails_package
-        add_react_dependencies
-        add_css_dependencies
-        add_rspack_dependencies if options.rspack?
-        add_dev_dependencies
-      end
-
-      def add_react_on_rails_package
-        major_minor_patch_only = /\A\d+\.\d+\.\d+\z/
-
-        # Try to use package_json gem first, fall back to direct npm commands
-        react_on_rails_pkg = if ReactOnRails::VERSION.match?(major_minor_patch_only)
-                               ["react-on-rails@#{ReactOnRails::VERSION}"]
-                             else
-                               puts "Adding the latest react-on-rails NPM module. " \
-                                    "Double check this is correct in package.json"
-                               ["react-on-rails"]
-                             end
-
-        puts "Installing React on Rails package..."
-        if add_npm_dependencies(react_on_rails_pkg)
-          @added_dependencies_to_package_json = true
-          return
-        end
-
-        puts "Using direct npm commands as fallback"
-        success = system("npm", "install", *react_on_rails_pkg)
-        @ran_direct_installs = true if success
-        handle_npm_failure("react-on-rails package", react_on_rails_pkg) unless success
-      end
-
-      def add_react_dependencies
-        puts "Installing React dependencies..."
-        react_deps = %w[
-          react
-          react-dom
-          @babel/preset-react
-          prop-types
-          babel-plugin-transform-react-remove-prop-types
-          babel-plugin-macros
-        ]
-        if add_npm_dependencies(react_deps)
-          @added_dependencies_to_package_json = true
-          return
-        end
-
-        success = system("npm", "install", *react_deps)
-        @ran_direct_installs = true if success
-        handle_npm_failure("React dependencies", react_deps) unless success
-      end
-
-      def add_css_dependencies
-        puts "Installing CSS handling dependencies..."
-        css_deps = %w[
-          css-loader
-          css-minimizer-webpack-plugin
-          mini-css-extract-plugin
-          style-loader
-        ]
-        if add_npm_dependencies(css_deps)
-          @added_dependencies_to_package_json = true
-          return
-        end
-
-        success = system("npm", "install", *css_deps)
-        @ran_direct_installs = true if success
-        handle_npm_failure("CSS dependencies", css_deps) unless success
-      end
-
-      def add_rspack_dependencies
-        puts "Installing Rspack core dependencies..."
-        rspack_deps = %w[
-          @rspack/core
-          rspack-manifest-plugin
-        ]
-        if add_npm_dependencies(rspack_deps)
-          @added_dependencies_to_package_json = true
-          return
-        end
-
-        success = system("npm", "install", *rspack_deps)
-        @ran_direct_installs = true if success
-        handle_npm_failure("Rspack dependencies", rspack_deps) unless success
-      end
-
-      def add_dev_dependencies
-        puts "Installing development dependencies..."
-        dev_deps = if options.rspack?
-                     %w[
-                       @rspack/cli
-                       @rspack/plugin-react-refresh
-                       react-refresh
-                     ]
-                   else
-                     %w[
-                       @pmmmwh/react-refresh-webpack-plugin
-                       react-refresh
-                     ]
-                   end
-        if add_npm_dependencies(dev_deps, dev: true)
-          @added_dependencies_to_package_json = true
-          return
-        end
-
-        success = system("npm", "install", "--save-dev", *dev_deps)
-        @ran_direct_installs = true if success
-        handle_npm_failure("development dependencies", dev_deps, dev: true) unless success
-      end
-
-      def install_js_dependencies
-        # Detect which package manager to use
-        success = if File.exist?(File.join(destination_root, "yarn.lock"))
-                    system("yarn", "install")
-                  elsif File.exist?(File.join(destination_root, "pnpm-lock.yaml"))
-                    system("pnpm", "install")
-                  elsif File.exist?(File.join(destination_root, "package-lock.json")) ||
-                        File.exist?(File.join(destination_root, "package.json"))
-                    # Use npm for package-lock.json or as default fallback
-                    system("npm", "install")
-                  else
-                    true # No package manager detected, skip
-                  end
-
-        unless success
-          GeneratorMessages.add_warning(<<~MSG.strip)
-            ⚠️  JavaScript dependencies installation failed.
-
-            This could be due to network issues or missing package manager.
-            You can install dependencies manually later by running:
-            • npm install (if using npm)
-            • yarn install (if using yarn)
-            • pnpm install (if using pnpm)
-          MSG
-        end
-
-        success
-      end
-
-      def handle_npm_failure(dependency_type, packages, dev: false)
-        install_command = dev ? "npm install --save-dev" : "npm install"
-        GeneratorMessages.add_warning(<<~MSG.strip)
-          ⚠️  Failed to install #{dependency_type}.
-
-          The following packages could not be installed automatically:
-          #{packages.map { |pkg| "  • #{pkg}" }.join("\n")}
-
-          This could be due to network issues or missing package manager.
-          You can install them manually later by running:
-            #{install_command} #{packages.join(' ')}
-        MSG
-      end
-
       # Removed: Shakapacker auto-installation logic (now explicit dependency)
 
       # Removed: Shakapacker 8+ is now required as explicit dependency

data/lib/generators/react_on_rails/js_dependency_manager.rb

@@ -0,0 +1,332 @@
+# frozen_string_literal: true
+
+require_relative "generator_messages"
+
+# rubocop:disable Metrics/ModuleLength
+module ReactOnRails
+  module Generators
+    # Shared module for managing JavaScript dependencies across generators
+    # This module provides common functionality for adding and installing
+    # JS dependencies to avoid code duplication between generators.
+    #
+    # Since react_on_rails requires shakapacker, and shakapacker includes
+    # package_json as a dependency, the package_json gem is always available.
+    #
+    # == Required Methods
+    # Including classes must include GeneratorHelper module which provides:
+    # - add_npm_dependencies(packages, dev: false): Add packages via package_json gem
+    # - package_json: Access to PackageJson instance (always available via shakapacker)
+    # - destination_root: Generator destination directory
+    #
+    # == Optional Methods
+    # Including classes may define:
+    # - options.rspack?: Returns true if --rspack flag is set (for Rspack support)
+    # - options.typescript?: Returns true if --typescript flag is set (for TypeScript support)
+    #
+    # == Installation Behavior
+    # The module ALWAYS runs package manager install after adding dependencies.
+    # This is safe because package_json gem's install method is idempotent - it only
+    # installs what's actually needed from package.json. This prevents edge cases
+    # where package.json was modified but dependencies weren't installed.
+    #
+    # == Error Handling Philosophy
+    # All dependency addition methods use a graceful degradation approach:
+    # - Methods return false on failure instead of raising exceptions
+    # - StandardError is caught at the lowest level (add_package) and higher levels (add_*_dependencies)
+    # - Failures trigger user-facing warnings via GeneratorMessages
+    # - Warnings provide clear manual installation instructions
+    #
+    # This ensures the generator ALWAYS completes successfully, even when:
+    # - Network connectivity issues prevent package downloads
+    # - Package manager (npm/yarn/pnpm) has permission errors
+    # - package_json gem encounters unexpected states
+    #
+    # Users can manually run package installation commands after generator completion.
+    # This is preferable to generator crashes that leave Rails apps in incomplete states.
+    #
+    # == Usage
+    # Include this module in generator classes and call setup_js_dependencies
+    # to handle all JS dependency installation via package_json gem.
+    module JsDependencyManager
+      # Core React dependencies required for React on Rails
+      # Note: @babel/preset-react and babel plugins are NOT included here because:
+      # - Shakapacker handles JavaScript transpiler configuration (babel, swc, or esbuild)
+      # - Users configure their preferred transpiler via shakapacker.yml javascript_transpiler setting
+      # - SWC is now the default and doesn't need Babel presets
+      # - For Babel users, shakapacker will install babel-loader and its dependencies
+      REACT_DEPENDENCIES = %w[
+        react
+        react-dom
+        prop-types
+      ].freeze
+
+      # CSS processing dependencies for webpack
+      CSS_DEPENDENCIES = %w[
+        css-loader
+        css-minimizer-webpack-plugin
+        mini-css-extract-plugin
+        style-loader
+      ].freeze
+
+      # Development-only dependencies for hot reloading (Webpack)
+      DEV_DEPENDENCIES = %w[
+        @pmmmwh/react-refresh-webpack-plugin
+        react-refresh
+      ].freeze
+
+      # Rspack core dependencies (only installed when --rspack flag is used)
+      RSPACK_DEPENDENCIES = %w[
+        @rspack/core
+        rspack-manifest-plugin
+      ].freeze
+
+      # Rspack development dependencies for hot reloading
+      RSPACK_DEV_DEPENDENCIES = %w[
+        @rspack/cli
+        @rspack/plugin-react-refresh
+        react-refresh
+      ].freeze
+
+      # TypeScript dependencies (only installed when --typescript flag is used)
+      # Note: @babel/preset-typescript is NOT included because:
+      # - SWC is now the default javascript_transpiler (has built-in TypeScript support)
+      # - Shakapacker handles the transpiler configuration via shakapacker.yml
+      # - If users choose javascript_transpiler: 'babel', they should manually add @babel/preset-typescript
+      #   and configure it in their babel.config.js
+      TYPESCRIPT_DEPENDENCIES = %w[
+        typescript
+        @types/react
+        @types/react-dom
+      ].freeze
+
+      private
+
+      def setup_js_dependencies
+        add_js_dependencies
+
+        # Always run install to ensure all dependencies are properly installed.
+        # The package_json gem's install method is idempotent and safe to call
+        # even if packages were already added - it will only install what's needed.
+        # This ensures edge cases where package.json was modified but install wasn't
+        # run are handled correctly.
+        install_js_dependencies
+      end
+
+      def add_js_dependencies
+        add_react_on_rails_package
+        add_react_dependencies
+        add_css_dependencies
+        # Rspack dependencies are only added when --rspack flag is used
+        add_rspack_dependencies if respond_to?(:options) && options&.rspack?
+        # Dev dependencies vary based on bundler choice
+        add_dev_dependencies
+      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}"
+                             else
+                               puts "Adding the latest react-on-rails NPM module. " \
+                                    "Double check this is correct in package.json"
+                               "react-on-rails"
+                             end
+
+        puts "Installing React on Rails package..."
+        return if add_package(react_on_rails_pkg)
+
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  Failed to add react-on-rails package.
+
+          You can install it manually by running:
+            npm install #{react_on_rails_pkg}
+        MSG
+      rescue StandardError => e
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  Error adding react-on-rails package: #{e.message}
+
+          You can install it manually by running:
+            npm install #{react_on_rails_pkg}
+        MSG
+      end
+
+      def add_react_dependencies
+        puts "Installing React dependencies..."
+        return if add_packages(REACT_DEPENDENCIES)
+
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  Failed to add React dependencies.
+
+          You can install them manually by running:
+            npm install #{REACT_DEPENDENCIES.join(' ')}
+        MSG
+      rescue StandardError => e
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  Error adding React dependencies: #{e.message}
+
+          You can install them manually by running:
+            npm install #{REACT_DEPENDENCIES.join(' ')}
+        MSG
+      end
+
+      def add_css_dependencies
+        puts "Installing CSS handling dependencies..."
+        return if add_packages(CSS_DEPENDENCIES)
+
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  Failed to add CSS dependencies.
+
+          You can install them manually by running:
+            npm install #{CSS_DEPENDENCIES.join(' ')}
+        MSG
+      rescue StandardError => e
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  Error adding CSS dependencies: #{e.message}
+
+          You can install them manually by running:
+            npm install #{CSS_DEPENDENCIES.join(' ')}
+        MSG
+      end
+
+      def add_rspack_dependencies
+        puts "Installing Rspack core dependencies..."
+        return if add_packages(RSPACK_DEPENDENCIES)
+
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  Failed to add Rspack dependencies.
+
+          You can install them manually by running:
+            npm install #{RSPACK_DEPENDENCIES.join(' ')}
+        MSG
+      rescue StandardError => e
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  Error adding Rspack dependencies: #{e.message}
+
+          You can install them manually by running:
+            npm install #{RSPACK_DEPENDENCIES.join(' ')}
+        MSG
+      end
+
+      def add_typescript_dependencies
+        puts "Installing TypeScript dependencies..."
+        return if add_packages(TYPESCRIPT_DEPENDENCIES, dev: true)
+
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  Failed to add TypeScript dependencies.
+
+          You can install them manually by running:
+            npm install --save-dev #{TYPESCRIPT_DEPENDENCIES.join(' ')}
+        MSG
+      rescue StandardError => e
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  Error adding TypeScript dependencies: #{e.message}
+
+          You can install them manually by running:
+            npm install --save-dev #{TYPESCRIPT_DEPENDENCIES.join(' ')}
+        MSG
+      end
+
+      def add_dev_dependencies
+        puts "Installing development dependencies..."
+
+        # Use Rspack-specific dev dependencies if --rspack flag is set
+        dev_deps = if respond_to?(:options) && options&.rspack?
+                     RSPACK_DEV_DEPENDENCIES
+                   else
+                     DEV_DEPENDENCIES
+                   end
+
+        return if add_packages(dev_deps, dev: true)
+
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  Failed to add development dependencies.
+
+          You can install them manually by running:
+            npm install --save-dev #{dev_deps.join(' ')}
+        MSG
+      rescue StandardError => e
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  Error adding development dependencies: #{e.message}
+
+          You can install them manually by running:
+            npm install --save-dev #{dev_deps.join(' ')}
+        MSG
+      end
+
+      # Add a single dependency using package_json gem
+      #
+      # This method is used internally for adding the react-on-rails package
+      # with version-specific handling (react-on-rails@VERSION).
+      # For batch operations, use add_packages instead.
+      #
+      # The exact: true flag ensures version pinning aligns with the gem version,
+      # preventing version mismatches between the Ruby gem and NPM package.
+      #
+      # @param package [String] Package specifier (e.g., "react-on-rails@16.0.0")
+      # @param dev [Boolean] Whether to add as dev dependency
+      # @return [Boolean] true if successful, false otherwise
+      def add_package(package, dev: false)
+        pj = package_json
+        return false unless pj
+
+        begin
+          # Ensure package is in array format for package_json gem
+          packages_array = [package]
+          if dev
+            pj.manager.add(packages_array, type: :dev, exact: true)
+          else
+            pj.manager.add(packages_array, exact: true)
+          end
+          true
+        rescue StandardError
+          # Return false to trigger warning in calling method
+          false
+        end
+      end
+
+      # Add multiple dependencies at once using package_json gem
+      #
+      # This method delegates to GeneratorHelper's add_npm_dependencies for
+      # better package manager abstraction and batch processing efficiency.
+      #
+      # @param packages [Array<String>] Package names to add
+      # @param dev [Boolean] Whether to add as dev dependencies
+      # @return [Boolean] true if successful, false otherwise
+      def add_packages(packages, dev: false)
+        # Use the add_npm_dependencies helper from GeneratorHelper
+        add_npm_dependencies(packages, dev: dev)
+      end
+
+      def install_js_dependencies
+        # Use package_json gem's install method (always available via shakapacker)
+        # package_json is guaranteed to be available because:
+        # 1. react_on_rails gemspec requires shakapacker
+        # 2. shakapacker gemspec requires package_json
+        # 3. GeneratorHelper provides package_json method
+        pj = package_json
+        unless pj
+          GeneratorMessages.add_warning("package_json not available, skipping dependency installation")
+          return false
+        end
+
+        pj.manager.install
+        true
+      rescue StandardError => e
+        GeneratorMessages.add_warning(<<~MSG.strip)
+          ⚠️  JavaScript dependencies installation failed: #{e.message}
+
+          This could be due to network issues or package manager problems.
+          You can install dependencies manually later by running:
+          • npm install (if using npm)
+          • yarn install (if using yarn)
+          • pnpm install (if using pnpm)
+        MSG
+        false
+      end
+    end
+  end
+end
+# rubocop:enable Metrics/ModuleLength

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

@@ -1,67 +1,47 @@
 # frozen_string_literal: true
 
-# See https://github.com/shakacode/react_on_rails/blob/master/docs/guides/configuration.md
-# for many more options.
+# React on Rails configuration
+# See https://github.com/shakacode/react_on_rails/blob/master/docs/api-reference/configuration.md
+# for complete documentation of all configuration options.
 
 ReactOnRails.configure do |config|
-  # This configures the script to run to build the production assets by webpack. Set this to nil
-  # if you don't want react_on_rails building this file for you.
-  # If nil, then the standard shakacode/shakapacker assets:precompile will run
-  # config.build_production_command = nil
-
-  ################################################################################
   ################################################################################
-  # TEST CONFIGURATION OPTIONS
-  # Below options are used with the use of this test helper:
-  # ReactOnRails::TestHelper.configure_rspec_to_compile_assets(config)
+  # Server Rendering (Recommended)
   ################################################################################
-
-  # If you are using this in your spec_helper.rb (or rails_helper.rb):
-  #
-  # ReactOnRails::TestHelper.configure_rspec_to_compile_assets(config)
-  #
-  # with rspec then this controls what npm command is run
-  # to automatically refresh your webpack assets on every test run.
-  #
-  # Alternately, you can remove the `ReactOnRails::TestHelper.configure_rspec_to_compile_assets`
-  # and set the config/shakapacker.yml option for test to true.
-  config.build_test_command = "RAILS_ENV=test bin/shakapacker"
+  # Configure server bundle for server-side rendering with `prerender: true`
+  # Set to "" if you're not using server rendering
+  config.server_bundle_js_file = "server-bundle.js"
 
   ################################################################################
+  # Test Configuration (Optional)
   ################################################################################
-  # SERVER RENDERING OPTIONS
-  ################################################################################
-  # This is the file used for server rendering of React when using `(prerender: true)`
-  # If you are never using server rendering, you should set this to "".
-  # Note, there is only one server bundle, unlike JavaScript where you want to minimize the size
-  # of the JS sent to the client. For the server rendering, React on Rails creates a pool of
-  # JavaScript execution instances which should handle any component requested.
+  # ⚠️ IMPORTANT: Two mutually exclusive approaches - use ONLY ONE:
   #
-  # While you may configure this to be the same as your client bundle file, this file is typically
-  # different. You should have ONE server bundle which can create all of your server rendered
-  # React components.
+  # RECOMMENDED APPROACH: Set `compile: true` in config/shakapacker.yml test section
+  # - Simpler configuration (no additional setup needed)
+  # - Handled automatically by Shakapacker
   #
-  config.server_bundle_js_file = "server-bundle.js"
-
-  # Configure where server bundles are output. Defaults to "ssr-generated".
-  # This should match your webpack configuration for server bundles.
-  config.server_bundle_output_path = "ssr-generated"
-
-  # 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
+  # ALTERNATIVE APPROACH: Uncomment below AND configure ReactOnRails::TestHelper
+  # - Provides explicit control over test asset compilation timing
+  # - Requires adding ReactOnRails::TestHelper to spec/rails_helper.rb
+  # - See: https://github.com/shakacode/react_on_rails/blob/master/docs/guides/testing-configuration.md
+  #
+  config.build_test_command = "RAILS_ENV=test bin/shakapacker"
 
-  ################################################################################
-  ################################################################################
-  # FILE SYSTEM BASED COMPONENT REGISTRY
-  ################################################################################
-  # `components_subdirectory`  is the name of the matching directories that contain automatically registered components
-  # for use in the Rails views. The default is nil, you can enable the feature by updating it in the next line.
+  config.auto_load_bundle = true
   config.components_subdirectory = "ror_components"
+  ################################################################################
+  # Advanced Configuration
+  ################################################################################
+  # Most configuration options have sensible defaults and don't need to be set.
+  # For advanced options including:
+  # - File-based component registry (components_subdirectory, auto_load_bundle)
+  # - Component loading strategies (async/defer/sync)
+  # - Server bundle security and organization
+  # - I18n configuration
+  # - Server rendering pool configuration
+  # - Custom rendering extensions
+  # - And more...
   #
-  # For automated component registry, `render_component` view helper method tries to load bundle for component from
-  # generated directory. default is false, you can pass option at the time of individual usage or update the default
-  # in the following line
-  config.auto_load_bundle = true
+  # See: https://github.com/shakacode/react_on_rails/blob/master/docs/api-reference/configuration.md
 end

data/lib/generators/react_on_rails/templates/base/base/config/shakapacker.yml

@@ -36,8 +36,15 @@ default: &default
   # Reload manifest.json on all requests so we reload latest compiled packs
   cache_manifest: false
 
-  # Select loader to use, available options are 'babel' (default), 'swc' or 'esbuild'
-  webpack_loader: 'babel'
+  # Select JavaScript transpiler to use
+  # Available options: 'swc' (default, 20x faster), 'babel', 'esbuild', or 'none'
+  # Use 'none' when providing a completely custom webpack configuration
+  # Note: When using rspack, swc is used automatically regardless of this setting
+  javascript_transpiler: "swc"
+
+  # Select assets bundler to use
+  # Available options: 'webpack' (default) or 'rspack'
+  assets_bundler: "webpack"
 
   # Raises an error if there is a mismatch in the shakapacker gem and npm package being used
   ensure_consistent_versioning: true
@@ -55,6 +62,11 @@ default: &default
   # https://webpack.js.org/guides/build-performance/#avoid-production-specific-tooling
   useContentHash: false
 
+  # On-demand compilation of packs when modified. Defaults to false.
+  # Set to false if using bin/shakapacker-dev-server or bin/shakapacker --watch via Procfiles.
+  # Set to true only in test environment for on-demand compilation.
+  compile: false
+
   # Setting the asset host here will override Rails.application.config.asset_host.
   # Here, you can set different asset_host per environment. Note that
   # SHAKAPACKER_ASSET_HOST will override both configurations.
@@ -72,7 +84,6 @@ default: &default
 
 development:
   <<: *default
-  compile: true
   compiler_strategy: mtime
 
   # Reference: https://webpack.js.org/configuration/dev-server/