react_on_rails 16.1.2 → 16.2.0

data/sig/react_on_rails/dev/service_checker.rbs

@@ -0,0 +1,22 @@
+module ReactOnRails
+  module Dev
+    class ServiceChecker
+      def self.check_services: (?config_path: String) -> bool
+
+      private
+
+      def self.config_has_services?: (Hash[String, untyped]?) -> bool
+      def self.check_and_report_services: (Hash[String, untyped], String) -> bool
+      def self.collect_service_failures: (Hash[String, untyped]) -> Array[Hash[Symbol, untyped]]
+      def self.report_results: (Array[Hash[Symbol, untyped]]) -> bool
+      def self.load_config: (String) -> Hash[String, untyped]?
+      def self.check_service: (String, Hash[String, untyped]) -> bool
+      def self.run_check_command: (String) -> [String, Process::Status?]
+      def self.print_services_header: (String) -> void
+      def self.print_service_ok: (String, String?) -> void
+      def self.print_service_failed: (String, String?) -> void
+      def self.print_all_services_ok: () -> void
+      def self.print_failures_summary: (Array[Hash[Symbol, untyped]]) -> void
+    end
+  end
+end

data/sig/react_on_rails/error.rbs

@@ -0,0 +1,4 @@
+module ReactOnRails
+  class Error < StandardError
+  end
+end

data/sig/react_on_rails/generators/js_dependency_manager.rbs

@@ -0,0 +1,123 @@
+# frozen_string_literal: true
+
+module ReactOnRails
+  module Generators
+    # Type signatures for JsDependencyManager module
+    #
+    # This module provides common functionality for managing JavaScript dependencies
+    # in Rails generators using the package_json gem (available via shakapacker).
+    module JsDependencyManager
+      # Core React dependencies required for React on Rails
+      REACT_DEPENDENCIES: Array[String]
+
+      # CSS processing dependencies for webpack
+      CSS_DEPENDENCIES: Array[String]
+
+      # Development-only dependencies for hot reloading (Webpack)
+      DEV_DEPENDENCIES: Array[String]
+
+      # Rspack core dependencies (only installed when --rspack flag is used)
+      RSPACK_DEPENDENCIES: Array[String]
+
+      # Rspack development dependencies for hot reloading
+      RSPACK_DEV_DEPENDENCIES: Array[String]
+
+      # TypeScript dependencies (only installed when --typescript flag is used)
+      TYPESCRIPT_DEPENDENCIES: Array[String]
+
+      private
+
+      # Sets up JavaScript dependencies by adding and installing packages
+      #
+      # This method orchestrates the entire dependency setup process:
+      # 1. Adds all required packages to package.json
+      # 2. Runs package manager install
+      #
+      # @return [void]
+      def setup_js_dependencies: () -> void
+
+      # Adds all JavaScript dependencies to package.json
+      #
+      # This method calls individual add_*_dependencies methods in sequence.
+      # All errors are handled gracefully with warnings rather than exceptions.
+      #
+      # @return [void]
+      def add_js_dependencies: () -> void
+
+      # Adds the react-on-rails package to package.json
+      #
+      # Uses version matching for stable releases, or latest for pre-releases.
+      # Adds error message to GeneratorMessages if package addition fails.
+      #
+      # @return [void]
+      def add_react_on_rails_package: () -> void
+
+      # Adds React dependencies to package.json
+      #
+      # Adds error message to GeneratorMessages if package addition fails.
+      #
+      # @return [void]
+      def add_react_dependencies: () -> void
+
+      # Adds CSS processing dependencies to package.json
+      #
+      # Adds error message to GeneratorMessages if package addition fails.
+      #
+      # @return [void]
+      def add_css_dependencies: () -> void
+
+      # Adds Rspack dependencies to package.json
+      #
+      # Only called when --rspack flag is set.
+      # Adds error message to GeneratorMessages if package addition fails.
+      #
+      # @return [void]
+      def add_rspack_dependencies: () -> void
+
+      # Adds TypeScript dependencies to package.json as dev dependencies
+      #
+      # Only called when --typescript flag is set.
+      # Adds error message to GeneratorMessages if package addition fails.
+      #
+      # @return [void]
+      def add_typescript_dependencies: () -> void
+
+      # Adds development dependencies to package.json
+      #
+      # Chooses between Webpack or Rspack dev dependencies based on --rspack flag.
+      # Adds error message to GeneratorMessages if package addition fails.
+      #
+      # @return [void]
+      def add_dev_dependencies: () -> void
+
+      # Adds a single package 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.
+      #
+      # @param package [String] Package specifier (e.g., "react-on-rails@16.0.0")
+      # @param dev [bool] Whether to add as dev dependency
+      # @return [bool] true if successful, false otherwise
+      def add_package: (String package, ?dev: bool) -> bool
+
+      # Adds multiple packages at once using package_json gem
+      #
+      # 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 [bool] Whether to add as dev dependencies
+      # @return [bool] true if successful, false otherwise
+      def add_packages: (Array[String] packages, ?dev: bool) -> bool
+
+      # Installs JavaScript dependencies using package_json gem
+      #
+      # Always available via shakapacker dependency chain.
+      # Adds warning to GeneratorMessages if installation fails.
+      #
+      # @return [bool] true if successful, false otherwise
+      def install_js_dependencies: () -> bool
+    end
+  end
+end

data/sig/react_on_rails/git_utils.rbs

@@ -0,0 +1,8 @@
+module ReactOnRails
+  module GitUtils
+    def self.uncommitted_changes?: (String path) -> bool
+    def self.git_installed?: () -> bool
+    def self.current_branch: () -> String?
+    def self.rspec_fixture_branches: () -> Array[String]
+  end
+end

data/sig/react_on_rails/helper.rbs

@@ -0,0 +1,65 @@
+module ReactOnRails
+  module Helper
+    # Type alias for ActiveSupport::SafeBuffer (html_safe strings)
+    type safe_buffer = String
+
+    COMPONENT_HTML_KEY: String
+
+    # Main helper methods
+    # Returns html_safe string (ActiveSupport::SafeBuffer)
+    def react_component: (
+      String component_name,
+      ?Hash[Symbol, untyped] options
+    ) ?{ () -> untyped } -> safe_buffer
+
+    # Returns hash with html_safe strings (ActiveSupport::SafeBuffer)
+    def react_component_hash: (
+      String component_name,
+      ?Hash[Symbol, untyped] options
+    ) ?{ () -> untyped } -> Hash[String, safe_buffer]
+
+    # Returns html_safe string (ActiveSupport::SafeBuffer)
+    def redux_store: (
+      String store_name,
+      ?Hash[Symbol, untyped] | String props
+    ) -> safe_buffer
+
+    # Returns html_safe string (ActiveSupport::SafeBuffer)
+    def redux_store_hydration_data: () -> safe_buffer
+
+    # Returns html_safe string (ActiveSupport::SafeBuffer)
+    def server_render_js: (
+      String js_expression,
+      ?Hash[Symbol, untyped] options
+    ) -> safe_buffer
+
+    def sanitized_props_string: (Hash[Symbol, untyped] | String props) -> String
+
+    def rails_context: (
+      ?server_side: bool
+    ) -> Hash[Symbol, untyped]
+
+    private
+
+    def internal_react_component: (
+      String component_name,
+      Hash[Symbol, untyped] options
+    ) ?{ () -> untyped } -> Hash[Symbol, untyped]
+
+    def build_react_component_result_for_server_rendered_string: (
+      server_rendered_html: String,
+      component_specification_tag: String,
+      console_script: String,
+      render_options: Hash[Symbol, untyped]
+    ) -> safe_buffer
+
+    def build_react_component_result_for_server_rendered_hash: (
+      server_rendered_html: Hash[String, untyped],
+      component_specification_tag: String,
+      console_script: String,
+      render_options: Hash[Symbol, untyped]
+    ) -> Hash[String, safe_buffer]
+
+    def prepend_render_rails_context: (String result) -> safe_buffer
+  end
+end

data/sig/react_on_rails/json_parse_error.rbs

@@ -0,0 +1,10 @@
+module ReactOnRails
+  class JsonParseError < ::ReactOnRails::Error
+    attr_reader json: String
+
+    def initialize: (parse_error: StandardError, json: String) -> void
+    def to_honeybadger_context: () -> Hash[Symbol, untyped]
+    def raven_context: () -> Hash[Symbol, untyped]
+    def to_error_context: () -> Hash[Symbol, untyped]
+  end
+end

data/sig/react_on_rails/locales.rbs

@@ -0,0 +1,46 @@
+module ReactOnRails
+  module Locales
+    def self.compile: (?force: bool) -> (ToJs | ToJson)
+    def self.check_config_directory_exists: (directory: String?, key_name: String, remove_if: String) -> void
+
+    class Base
+      def initialize: (?force: bool) -> void
+
+      private
+
+      def file_format: () -> String?
+      def obsolete?: () -> bool
+      def exist_files: () -> Array[String]
+      def files_are_outdated: () -> bool
+      def file_names: () -> Array[String]
+      def files: () -> Array[String]
+      def file: (String name) -> String
+      def locale_files: () -> Array[String]
+      def i18n_dir: () -> String?
+      def i18n_yml_dir: () -> String?
+      def default_locale: () -> String
+      def convert: () -> void
+      def generate_file: (String template, String path) -> void
+      def generate_translations: () -> [String, String]
+      def format: (untyped input) -> Symbol
+      def flatten_defaults: (Hash[untyped, untyped] val) -> Hash[Symbol, Hash[Symbol, untyped]]
+      def flatten: (Hash[untyped, untyped] translations) -> Hash[Symbol, untyped]
+      def template_translations: () -> String
+      def template_default: () -> String
+    end
+
+    class ToJs < Base
+      private
+
+      def file_format: () -> String
+    end
+
+    class ToJson < Base
+      private
+
+      def file_format: () -> String
+      def template_translations: () -> String
+      def template_default: () -> String
+    end
+  end
+end

data/sig/react_on_rails/packer_utils.rbs

@@ -0,0 +1,15 @@
+module ReactOnRails
+  module PackerUtils
+    def self.supports_autobundling?: () -> bool
+    def self.supports_basic_pack_generation?: () -> bool
+    def self.supports_async_loading?: () -> bool
+    def self.nested_entries?: () -> bool
+    def self.packer_public_output_path: () -> String
+    def self.precompile?: () -> bool
+    def self.shakapacker_precompile_hook_configured?: () -> bool
+    def self.shakapacker_precompile_hook_value: () -> String
+    def self.raise_shakapacker_version_incompatible_for_autobundling: () -> void
+    def self.raise_shakapacker_version_incompatible_for_basic_pack_generation: () -> void
+    def self.raise_nested_entries_disabled: () -> void
+  end
+end

data/sig/react_on_rails/prerender_error.rbs

@@ -0,0 +1,21 @@
+module ReactOnRails
+  class PrerenderError < ::ReactOnRails::Error
+    MAX_ERROR_SNIPPET_TO_LOG: Integer
+
+    attr_reader component_name: String?
+    attr_reader err: StandardError?
+    attr_reader props: String?
+    attr_reader js_code: String?
+    attr_reader console_messages: String?
+
+    def initialize: (?component_name: String?, ?err: StandardError?, ?props: String?, ?js_code: String?, ?console_messages: String?) -> void
+    def to_honeybadger_context: () -> Hash[Symbol, untyped]
+    def raven_context: () -> Hash[Symbol, untyped]
+    def to_error_context: () -> Hash[Symbol, untyped]
+
+    private
+
+    def calc_message: (String? component_name, String? console_messages, StandardError? err, String? js_code, String? props) -> [String?, String]
+    def build_troubleshooting_suggestions: (String? component_name, StandardError? err, String? console_messages) -> String
+  end
+end

data/sig/react_on_rails/server_rendering_pool.rbs

@@ -0,0 +1,12 @@
+module ReactOnRails
+  module ServerRenderingPool
+    def self.pool: () -> untyped
+
+    def self.reset_pool_if_server_bundle_was_modified: () -> void
+    def self.reset_pool: () -> void
+    def self.server_render_js_with_console_logging: (
+      String js_code,
+      Hash[Symbol, untyped] render_options
+    ) -> Hash[String, untyped]
+  end
+end

data/sig/react_on_rails/smart_error.rbs

@@ -0,0 +1,28 @@
+module ReactOnRails
+  class SmartError < Error
+    attr_reader error_type: Symbol
+    attr_reader component_name: String?
+    attr_reader props: String?
+    attr_reader js_code: String?
+    attr_reader additional_context: Hash[Symbol, untyped]
+
+    def initialize: (error_type: Symbol, ?component_name: String?, ?props: String?, ?js_code: String?, **untyped additional_context) -> void
+    def solution: () -> String
+
+    private
+
+    def build_error_message: () -> String
+    def error_type_title: () -> String
+    def error_description: () -> String
+    def component_not_registered_solution: () -> String
+    def missing_auto_loaded_bundle_solution: () -> String
+    def hydration_mismatch_solution: () -> String
+    def server_rendering_error_solution: () -> String
+    def redux_store_not_found_solution: () -> String
+    def configuration_error_solution: () -> String
+    def default_solution: () -> String
+    def additional_info: () -> String
+    def troubleshooting_section: () -> String
+    def find_similar_components: (String name) -> Array[String]
+  end
+end

data/sig/react_on_rails/test_helper.rbs

@@ -0,0 +1,11 @@
+module ReactOnRails
+  module TestHelper
+    def self.configure_rspec_to_compile_assets: (untyped config) -> void
+    def self.ensure_assets_compiled: (?force_compile: bool) -> void
+    def self.webpack_assets_compiled?: () -> bool
+
+    module EnsureAssetsCompiled
+      def self.has_been_run?: () -> bool
+    end
+  end
+end

data/sig/react_on_rails/utils.rbs

@@ -0,0 +1,34 @@
+module ReactOnRails
+  module Utils
+    TRUNCATION_FILLER: String
+
+    def self.truthy_presence: (untyped obj) -> untyped
+    def self.wrap_message: (String msg, ?Symbol color) -> String
+    def self.object_to_boolean: (untyped value) -> bool
+    def self.server_rendering_is_enabled?: () -> bool
+    def self.invoke_and_exit_if_failed: (String cmd, String failure_message) -> Array[String]
+    def self.server_bundle_path_is_http?: () -> bool
+    def self.bundle_js_file_path: (String bundle_name) -> String
+    def self.react_on_rails_pro?: () -> bool
+    def self.react_on_rails_pro_version: () -> String?
+    def self.rsc_support_enabled?: () -> bool
+    def self.full_text_errors_enabled?: () -> bool
+    def self.smart_trim: (String str, ?Integer max_length) -> String
+    def self.find_most_recent_mtime: (Array[String] files) -> Time?
+    def self.prepend_to_file_if_text_not_present: (file: String, text_to_prepend: String, regex: Regexp) -> void
+    def self.detect_package_manager: () -> String
+    def self.default_troubleshooting_section: () -> String
+    def self.server_bundle_js_file_path: () -> String
+    def self.running_on_windows?: () -> bool
+    def self.rails_version_less_than: (String version) -> bool
+    def self.rails_version_less_than_4_1_1?: () -> bool
+    def self.source_path: () -> String
+    def self.public_bundles_full_path: () -> String
+    def self.generated_assets_full_path: () -> String
+    def self.gem_available?: (String name) -> bool
+
+    module Required
+      def required: (String name) -> untyped
+    end
+  end
+end

data/sig/react_on_rails/version_checker.rbs

@@ -0,0 +1,12 @@
+module ReactOnRails
+  module VersionChecker
+    def self.log_if_gem_and_node_package_versions_differ: () -> void
+
+    private
+
+    def self.node_package_version: () -> String?
+    def self.gem_version: () -> String
+    def self.node_package_version_different_from_gem?: () -> bool
+    def self.pr_1683_warning: () -> String
+  end
+end

data/sig/react_on_rails.rbs

@@ -0,0 +1,17 @@
+# Type signatures for ReactOnRails gem
+
+module ReactOnRails
+  VERSION: String
+
+  DEFAULT_GENERATED_ASSETS_DIR: String
+  DEFAULT_COMPONENT_REGISTRY_TIMEOUT: Integer
+
+  def self.configure: () { (Configuration) -> void } -> void
+  def self.configuration: () -> Configuration
+
+  # Error classes are defined in separate RBS files:
+  # - sig/react_on_rails/prerender_error.rbs
+  # - sig/react_on_rails/json_parse_error.rbs
+  class Error < StandardError
+  end
+end

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: react_on_rails
 version: !ruby/object:Gem::Version
-  version: 16.1.2
+  version: 16.2.0
 platform: ruby
 authors:
 - Justin Gordon
+autorequire:
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-01-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -114,34 +115,14 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- AI_AGENT_INSTRUCTIONS.md
-- CHANGELOG.md
-- CLAUDE.md
-- CODING_AGENTS.md
-- CONTRIBUTING.md
-- Dockerfile_tests
+- ".rspec"
+- ".rubocop.yml"
 - Gemfile
 - Gemfile.development_dependencies
 - Gemfile.lock
-- KUDOS.md
-- LICENSE.md
-- LICENSES/README.md
-- NEWS.md
-- PROJECTS.md
-- REACT-ON-RAILS-PRO-LICENSE.md
-- README.md
 - Rakefile
-- SUMMARY.md
-- TODO.md
+- Steepfile
 - app/helpers/react_on_rails_helper.rb
-- bin/lefthook/check-trailing-newlines
-- bin/lefthook/get-changed-files
-- bin/lefthook/prettier-format
-- bin/lefthook/ruby-autofix
-- bin/lefthook/ruby-lint
-- docker-compose.yml
-- eslint.config.ts
-- knip.ts
 - lib/generators/USAGE
 - lib/generators/react_on_rails/USAGE
 - lib/generators/react_on_rails/base_generator.rb
@@ -149,9 +130,11 @@ files:
 - lib/generators/react_on_rails/generator_helper.rb
 - lib/generators/react_on_rails/generator_messages.rb
 - lib/generators/react_on_rails/install_generator.rb
+- lib/generators/react_on_rails/js_dependency_manager.rb
 - lib/generators/react_on_rails/react_no_redux_generator.rb
 - lib/generators/react_on_rails/react_with_redux_generator.rb
 - lib/generators/react_on_rails/templates/.eslintrc
+- lib/generators/react_on_rails/templates/base/base/.dev-services.yml.example
 - lib/generators/react_on_rails/templates/base/base/Procfile.dev
 - lib/generators/react_on_rails/templates/base/base/Procfile.dev-prod-assets
 - lib/generators/react_on_rails/templates/base/base/Procfile.dev-static-assets
@@ -169,8 +152,10 @@ files:
 - lib/generators/react_on_rails/templates/base/base/app/views/layouts/hello_world.html.erb
 - lib/generators/react_on_rails/templates/base/base/babel.config.js.tt
 - lib/generators/react_on_rails/templates/base/base/bin/dev
+- 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
@@ -210,6 +195,7 @@ files:
 - lib/react_on_rails/dev/pack_generator.rb
 - lib/react_on_rails/dev/process_manager.rb
 - lib/react_on_rails/dev/server_manager.rb
+- lib/react_on_rails/dev/service_checker.rb
 - lib/react_on_rails/doctor.rb
 - lib/react_on_rails/engine.rb
 - lib/react_on_rails/error.rb
@@ -223,13 +209,12 @@ files:
 - lib/react_on_rails/packer_utils.rb
 - lib/react_on_rails/packs_generator.rb
 - lib/react_on_rails/prerender_error.rb
-- lib/react_on_rails/pro/NOTICE
-- lib/react_on_rails/pro/helper.rb
-- lib/react_on_rails/pro/utils.rb
+- lib/react_on_rails/pro_helper.rb
 - lib/react_on_rails/react_component/render_options.rb
 - lib/react_on_rails/server_rendering_js_code.rb
 - lib/react_on_rails/server_rendering_pool.rb
 - lib/react_on_rails/server_rendering_pool/ruby_embedded_java_script.rb
+- lib/react_on_rails/smart_error.rb
 - lib/react_on_rails/system_checker.rb
 - lib/react_on_rails/test_helper.rb
 - lib/react_on_rails/test_helper/ensure_assets_compiled.rb
@@ -243,9 +228,40 @@ files:
 - lib/tasks/doctor.rake
 - lib/tasks/generate_packs.rake
 - lib/tasks/locale.rake
+- rakelib/docker.rake
+- rakelib/dummy_apps.rake
+- rakelib/example_type.rb
+- rakelib/examples_config.yml
+- rakelib/lint.rake
+- rakelib/node_package.rake
+- rakelib/rbs.rake
+- rakelib/run_rspec.rake
+- rakelib/shakapacker_examples.rake
+- rakelib/task_helpers.rb
+- rakelib/update_changelog.rake
 - react_on_rails.gemspec
-- tsconfig.eslint.json
-- tsconfig.json
+- sig/README.md
+- 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/dev/service_checker.rbs
+- sig/react_on_rails/error.rbs
+- sig/react_on_rails/generators/js_dependency_manager.rbs
+- sig/react_on_rails/git_utils.rbs
+- sig/react_on_rails/helper.rbs
+- sig/react_on_rails/json_parse_error.rbs
+- sig/react_on_rails/locales.rbs
+- sig/react_on_rails/packer_utils.rbs
+- sig/react_on_rails/prerender_error.rbs
+- sig/react_on_rails/server_rendering_pool.rbs
+- sig/react_on_rails/smart_error.rbs
+- sig/react_on_rails/test_helper.rbs
+- sig/react_on_rails/utils.rbs
+- sig/react_on_rails/version_checker.rbs
 homepage: https://github.com/shakacode/react_on_rails
 licenses:
 - MIT
@@ -271,7 +287,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: Rails with react server rendering with webpack.
 test_files: []

data/AI_AGENT_INSTRUCTIONS.md

@@ -1,63 +0,0 @@
-# 🤖 AI Agent Instructions: React on Rails Setup
-
-_Super concise, copy-paste instructions for AI agents to set up React on Rails in common scenarios._
-
-## 🔍 **Before Starting: Check Current Versions**
-
-```bash
-# Get latest available versions (recommended approach)
-gem search react_on_rails --remote
-```
-
-Install and update gem and npm package using strict option.
-
----
-
-## 🆕 Scenario 1: New Rails App with React on Rails
-
-```bash
-# Create new Rails app
-rails new myapp --skip-javascript --database=postgresql
-cd myapp
-
-# Use latest version
-bundle add react_on_rails --strict
-
-bin/rails generate react_on_rails:install
-
-# Accept change to bin/dev
-
-# Start development servers
-bin/dev
-```
-
-**✅ Success Check:** Visit `http://localhost:3000/hello_world` → Should see "Hello World" from React
-
----
-
-## 🔄 Scenario 2: Add React on Rails to Existing Rails App
-
-```bash
-cd /path/to/existing/app
-# Use latest version
-bundle add react_on_rails --strict
-
-bin/rails generate react_on_rails:install
-
-# Accept change to bin/dev
-
-# Start development servers
-bin/dev
-# Navigate to existing Rails app root
-
-# Start development
-bin/dev
-```
-
----
-
-## 🛠️ Common Troubleshooting Commands
-
-- Always run `bin/dev` to test setup, and check browser console for any JavaScript errors
-- `bin/dev kill` stops other conflicting processes
-- `bin/rake react_on_rails:doctor` for helpful information