Class: ReactOnRails::Generators::BaseGenerator

Inherits:

Rails::Generators::Base

• Object
• Rails::Generators::Base
• ReactOnRails::Generators::BaseGenerator

Includes:

GeneratorHelper, JsDependencyManager, ShakapackerPrecompileHookHelper

Defined in:

lib/generators/react_on_rails/base_generator.rb

Constant Summary

CONFIGURE_RSPEC_TO_COMPILE_ASSETS =

<<~STR
  # Ensure that if we are running js tests, we are using latest webpack assets
  # This will use the defaults of :js and :server_rendering meta tags
  # Requires config.build_test_command in config/initializers/react_on_rails.rb.
  # This is the default setup for React on Rails generated apps.
  ReactOnRails::TestHelper.configure_rspec_to_compile_assets(config)
STR

CONFIGURE_MINITEST_TO_COMPILE_ASSETS =

<<~STR
  # Ensure that tests run against fresh webpack assets.
  ActiveSupport::TestCase.setup do
    ReactOnRails::TestHelper.ensure_assets_compiled
  end
STR

Constants included from JsDependencyManager

JsDependencyManager::BABEL_REACT_DEPENDENCIES, JsDependencyManager::CSS_DEPENDENCIES, JsDependencyManager::DEV_DEPENDENCIES, JsDependencyManager::PRO_DEPENDENCIES, JsDependencyManager::REACT_DEPENDENCIES, JsDependencyManager::RSC_DEPENDENCIES, JsDependencyManager::RSC_PACKAGE_VERSION_PIN, JsDependencyManager::RSC_REACT_VERSION_RANGE, JsDependencyManager::RSPACK_DEPENDENCIES, JsDependencyManager::RSPACK_DEV_DEPENDENCIES, JsDependencyManager::SWC_DEPENDENCIES, JsDependencyManager::TYPESCRIPT_DEPENDENCIES

Instance Method Summary

• #add_base_gems_to_gemfile ⇒ Object
• #add_hello_world_route ⇒ Object
• #add_root_route ⇒ Object
• #append_to_spec_rails_helper ⇒ Object
• #copy_base_files ⇒ Object
• #copy_js_bundle_files ⇒ Object
• #copy_packer_config ⇒ Object
• #copy_webpack_config ⇒ Object
• #create_react_directories ⇒ Object
• #update_gitignore_for_auto_registration ⇒ Object

Methods included from GeneratorHelper

#add_documentation_reference, #add_npm_dependencies, #bundler_flag_given?, #component_extension, #destination_config_path, #detect_react_version, #explicit_bundler_choice, #gem_in_lockfile?, #package_json, #print_generator_messages, #pro_gem_installed?, #resolve_server_client_or_both_path, #root_route_present?, #shakapacker_version_9_or_higher?, #use_pro?, #use_rsc?, #using_rspack?, #using_swc?

Instance Method Details

#add_base_gems_to_gemfile ⇒ Object

# File 'lib/generators/react_on_rails/base_generator.rb', line 280

def add_base_gems_to_gemfile
  run "bundle"
end

#add_hello_world_route ⇒ Object

# File 'lib/generators/react_on_rails/base_generator.rb', line 166

def add_hello_world_route
  # RSC uses HelloServer instead of HelloWorld, but Redux still needs hello_world route
  return if use_rsc? && !options.redux?

  route "get 'hello_world', to: 'hello_world#index'"
end

#add_root_route ⇒ Object

# File 'lib/generators/react_on_rails/base_generator.rb', line 121

def add_root_route
  return unless options.new_app?
  # add_root_route normally runs before copy_base_files as a generator action.
  # Guard against accidental double invocation (for example, if future
  # refactors trigger lazy initialization in generate_new_app_home_page?).
  return if defined?(@new_app_root_route_added)

  @new_app_root_route_added = false

  if preexisting_root_route?
    say_status :skip, "Root route already exists; keeping existing root route", :yellow
    return
  end

  routes_path = "config/routes.rb"
  routes_full_path = File.join(destination_root, routes_path)

  unless File.file?(routes_full_path)
    say_status :warn, "Could not inject root route; config/routes.rb was not found", :yellow
    return
  end

  # Support both LF and CRLF route files so new-app onboarding works on Windows checkouts too.
  routes_draw_declaration = /^\s*Rails\.application\.routes\.draw do\r?\n/
  unless File.read(routes_full_path).match?(routes_draw_declaration)
    say_status :warn, "Could not inject root route; config/routes.rb format was unexpected", :yellow
    return
  end

  inject_into_file routes_path,
                   %(  root to: "home#index"\n),
                   after: routes_draw_declaration
  if options[:pretend]
    @new_app_root_route_added = true
    return
  end

  if File.read(routes_full_path).include?('root to: "home#index"')
    @new_app_root_route_added = true
    return
  end

  say_status :warn, "Could not inject root route; config/routes.rb format was unexpected", :yellow
end

#append_to_spec_rails_helper ⇒ Object

# File 'lib/generators/react_on_rails/base_generator.rb', line 304

def append_to_spec_rails_helper
  rspec_helper = preferred_rspec_helper_file
  add_configure_rspec_to_compile_assets(rspec_helper) if rspec_helper

  test_helper = File.join(destination_root, "test/test_helper.rb")
  add_configure_minitest_to_compile_assets(test_helper) if File.exist?(test_helper)
end

#copy_base_files ⇒ Object

# File 'lib/generators/react_on_rails/base_generator.rb', line 180

def copy_base_files
  ensure_new_app_root_route_initialized

  base_path = "base/base/"
  base_files = %w[Procfile.dev
                  Procfile.dev-static-assets
                  Procfile.dev-prod-assets
                  .dev-services.yml.example
                  .env.example
                  bin/shakapacker-precompile-hook]

  # react_on_rails_default layout provides empty pack tags so React on Rails can
  # inject generated packs without requiring a hardcoded application.js pack entry.
  base_files << "app/views/layouts/react_on_rails_default.html.erb"

  # HelloWorld controller only when not using RSC (RSC uses HelloServer)
  # Exception: Redux still needs the HelloWorld controller even with RSC
  base_files << "app/controllers/hello_world_controller.rb" unless use_rsc? && !options.redux?
  base_files << "app/controllers/home_controller.rb" if generate_new_app_home_page?
  base_templates = %w[config/initializers/react_on_rails.rb]
  base_files.each { |file| copy_file("#{base_path}#{file}", file) }
  base_templates.each do |file|
    template("#{base_path}/#{file}.tt", file)
  end

  if generate_new_app_home_page?
    empty_directory("app/views/home")
    template("#{base_path}/app/views/home/index.html.erb.tt", "app/views/home/index.html.erb", home_page_config)
  end

  # Make the hook script executable (copy_file guarantees it exists)
  if options[:pretend]
    say_status :pretend, "Skipping chmod on shakapacker-precompile-hook in --pretend mode", :yellow
  else
    File.chmod(0o755, File.join(destination_root, "bin/shakapacker-precompile-hook"))
  end
end

#copy_js_bundle_files ⇒ Object

# File 'lib/generators/react_on_rails/base_generator.rb', line 218

def copy_js_bundle_files
  base_path = "base/base/"
  base_files = %w[app/javascript/packs/server-bundle.js]

  # Skip HelloWorld CSS for Redux (uses HelloWorldApp) or RSC (uses HelloServer)
  unless options.redux? || use_rsc?
    base_files << "app/javascript/src/HelloWorld/ror_components/HelloWorld.module.css"
  end

  base_files.each { |file| copy_file("#{base_path}#{file}", file) }
end

#copy_packer_config ⇒ Object

# File 'lib/generators/react_on_rails/base_generator.rb', line 254

def copy_packer_config
  base_path = "base/base/"
  config = "config/shakapacker.yml"

  if options.shakapacker_just_installed?
    say "Replacing Shakapacker default config with React on Rails version"
    # Shakapacker's installer just created this file from scratch (no pre-existing config).
    # Safe to overwrite silently with RoR's version-aware template (e.g., private_output_path).
    template("#{base_path}#{config}.tt", config, force: true)
  else
    say "Adding Shakapacker #{ReactOnRails::PackerUtils.shakapacker_version} config"
    # Thor handles the conflict: prompts user interactively, or respects --force/--skip flags.
    template("#{base_path}#{config}.tt", config)
  end

  # Configure bundler-specific settings
  configure_rspack_in_shakapacker if using_rspack?

  # Always ensure precompile_hook is configured (Shakapacker 9.0+ only)
  configure_precompile_hook_in_shakapacker

  # For SSR bundles, configure Shakapacker private_output_path (9.0+ only)
  # This keeps Shakapacker and React on Rails server bundle paths in sync.
  configure_private_output_path_in_shakapacker
end

#copy_webpack_config ⇒ Object

# File 'lib/generators/react_on_rails/base_generator.rb', line 230

def copy_webpack_config
  # Cleanup must run before writing new webpack/rspack configs so we only
  # evaluate pre-existing stale entries, never files generated in this run.
  cleanup_stale_webpack_config_dir_for_rspack

  say "Adding #{using_rspack? ? 'Rspack' : 'Webpack'} config"
  base_path = "base/base"
  base_files = %w[babel.config.js
                  config/webpack/clientWebpackConfig.js
                  config/webpack/commonWebpackConfig.js
                  config/webpack/test.js
                  config/webpack/development.js
                  config/webpack/production.js
                  config/webpack/serverWebpackConfig.js
                  config/webpack/ServerClientOrBoth.js]
  config = { message: DOCS_REFERENCE_MESSAGE }
  base_files.each do |file|
    template("#{base_path}/#{file}.tt", destination_config_path(file), config)
  end

  # Handle webpack.config.js separately with smart replacement
  copy_webpack_main_config(base_path, config)
end

#create_react_directories ⇒ Object

# File 'lib/generators/react_on_rails/base_generator.rb', line 173

def create_react_directories
  # Skip HelloWorld directory for Redux (uses HelloWorldApp) or RSC (uses HelloServer)
  return if options.redux? || use_rsc?

  empty_directory("app/javascript/src/HelloWorld/ror_components")
end

#update_gitignore_for_auto_registration ⇒ Object

# File 'lib/generators/react_on_rails/base_generator.rb', line 284

def update_gitignore_for_auto_registration
  gitignore_path = File.join(destination_root, ".gitignore")
  return unless File.exist?(gitignore_path)

  gitignore_content = File.read(gitignore_path)

  additions = []
  additions << "**/generated/**" unless gitignore_content.include?("**/generated/**")
  additions << "ssr-generated" unless gitignore_content.include?("ssr-generated")
  additions << ".env" unless gitignore_content.match?(/^\.env$/)

  return if additions.empty?

  append_to_file ".gitignore" do
    lines = ["\n# React on Rails (generated and local files)"]
    lines.concat(additions)
    "#{lines.join("\n")}\n"
  end
end