react_on_rails 17.1.0 → 17.2.0.rc.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 62a0447050537a662a84a3f87f1a9a8ff970e8008ccf3919c818654ea29ffa7e
-  data.tar.gz: 69194bb2ad2b61f1843bbcc063e5188275f34f8dae4e97a68f3a90fff1b45670
+  metadata.gz: c84e036c05a85bb64d0cdd85522f712816cdd5e7b1042f7635920fa0db020b30
+  data.tar.gz: 0a45d5bf692c9260f9a1c7e1c7c0d19908aef14b874e8a61056d78ad454d4916
 SHA512:
-  metadata.gz: 51f1d167e98eade1f7df678e77d3d5c317cd3b6698dfa7aa2251a55131bfc31000c1f07cd79c3620ecc7ece6c43c89f0c9447a13f68ee78c3251172ca2d7c37c
-  data.tar.gz: 2d9dd8cd80a296ffd3325e544371f67d94e7bef3128afdef8adb6e32b3e46d647e260fd1a356af134efd633c5a00b03a7bc19d6933e15c57eb30c985df76e7c2
+  metadata.gz: '04318a00cc5eba9189a576110532ce85a9221331715c0bd71c10274bc40a02954d6679ed18aacda545b49a12238476d81016052196503a382c75f5c99f7118c9'
+  data.tar.gz: 1b666939069f951819cf62d035db80d3f3382ee797269a26cc19d445512d45927965f7383509f541e219e3fb4dd1590adec455e1ef453ea1232b425099731b5e

data/Gemfile

@@ -5,4 +5,4 @@ source "https://rubygems.org"
 # Specify your gem"s dependencies in react_on_rails.gemspec
 gemspec
 
-eval_gemfile File.expand_path("./Gemfile.development_dependencies", __dir__)
+Dir.chdir(__dir__) { eval_gemfile "./Gemfile.development_dependencies" }

data/Gemfile.development_dependencies

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
-eval_gemfile File.expand_path("../Gemfile.shared_dev_dependencies", __dir__)
+Dir.chdir(__dir__) { eval_gemfile "../Gemfile.shared_dev_dependencies" }
 
 gem "shakapacker", "10.3.2"
 gem "bootsnap", require: false
-gem "rails", "~> 7.1.0"
+gem "rails", ">= 7.2.3.2", "< 7.3"
 
 gem "sqlite3", "~> 2.0"
 gem "sass-rails", "~> 6.0"

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    react_on_rails (17.1.0)
+    react_on_rails (17.2.0.rc.0)
       addressable
       connection_pool
       execjs (~> 2.5)
@@ -12,85 +12,79 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    actioncable (7.1.6)
-      actionpack (= 7.1.6)
-      activesupport (= 7.1.6)
+    actioncable (7.2.3.2)
+      actionpack (= 7.2.3.2)
+      activesupport (= 7.2.3.2)
       nio4r (~> 2.0)
       websocket-driver (>= 0.6.1)
       zeitwerk (~> 2.6)
-    actionmailbox (7.1.6)
-      actionpack (= 7.1.6)
-      activejob (= 7.1.6)
-      activerecord (= 7.1.6)
-      activestorage (= 7.1.6)
-      activesupport (= 7.1.6)
-      mail (>= 2.7.1)
-      net-imap
-      net-pop
-      net-smtp
-    actionmailer (7.1.6)
-      actionpack (= 7.1.6)
-      actionview (= 7.1.6)
-      activejob (= 7.1.6)
-      activesupport (= 7.1.6)
-      mail (~> 2.5, >= 2.5.4)
-      net-imap
-      net-pop
-      net-smtp
+    actionmailbox (7.2.3.2)
+      actionpack (= 7.2.3.2)
+      activejob (= 7.2.3.2)
+      activerecord (= 7.2.3.2)
+      activestorage (= 7.2.3.2)
+      activesupport (= 7.2.3.2)
+      mail (>= 2.8.0)
+    actionmailer (7.2.3.2)
+      actionpack (= 7.2.3.2)
+      actionview (= 7.2.3.2)
+      activejob (= 7.2.3.2)
+      activesupport (= 7.2.3.2)
+      mail (>= 2.8.0)
       rails-dom-testing (~> 2.2)
-    actionpack (7.1.6)
-      actionview (= 7.1.6)
-      activesupport (= 7.1.6)
+    actionpack (7.2.3.2)
+      actionview (= 7.2.3.2)
+      activesupport (= 7.2.3.2)
       cgi
       nokogiri (>= 1.8.5)
       racc
-      rack (>= 2.2.4)
+      rack (>= 2.2.4, < 3.3)
       rack-session (>= 1.0.1)
       rack-test (>= 0.6.3)
       rails-dom-testing (~> 2.2)
       rails-html-sanitizer (~> 1.6)
-    actiontext (7.1.6)
-      actionpack (= 7.1.6)
-      activerecord (= 7.1.6)
-      activestorage (= 7.1.6)
-      activesupport (= 7.1.6)
+      useragent (~> 0.16)
+    actiontext (7.2.3.2)
+      actionpack (= 7.2.3.2)
+      activerecord (= 7.2.3.2)
+      activestorage (= 7.2.3.2)
+      activesupport (= 7.2.3.2)
       globalid (>= 0.6.0)
       nokogiri (>= 1.8.5)
-    actionview (7.1.6)
-      activesupport (= 7.1.6)
+    actionview (7.2.3.2)
+      activesupport (= 7.2.3.2)
       builder (~> 3.1)
       cgi
       erubi (~> 1.11)
       rails-dom-testing (~> 2.2)
       rails-html-sanitizer (~> 1.6)
-    activejob (7.1.6)
-      activesupport (= 7.1.6)
+    activejob (7.2.3.2)
+      activesupport (= 7.2.3.2)
       globalid (>= 0.3.6)
-    activemodel (7.1.6)
-      activesupport (= 7.1.6)
-    activerecord (7.1.6)
-      activemodel (= 7.1.6)
-      activesupport (= 7.1.6)
+    activemodel (7.2.3.2)
+      activesupport (= 7.2.3.2)
+    activerecord (7.2.3.2)
+      activemodel (= 7.2.3.2)
+      activesupport (= 7.2.3.2)
       timeout (>= 0.4.0)
-    activestorage (7.1.6)
-      actionpack (= 7.1.6)
-      activejob (= 7.1.6)
-      activerecord (= 7.1.6)
-      activesupport (= 7.1.6)
+    activestorage (7.2.3.2)
+      actionpack (= 7.2.3.2)
+      activejob (= 7.2.3.2)
+      activerecord (= 7.2.3.2)
+      activesupport (= 7.2.3.2)
       marcel (~> 1.0)
-    activesupport (7.1.6)
+    activesupport (7.2.3.2)
       base64
       benchmark (>= 0.3)
       bigdecimal
-      concurrent-ruby (~> 1.0, >= 1.0.2)
+      concurrent-ruby (~> 1.0, >= 1.3.1)
       connection_pool (>= 2.2.5)
       drb
       i18n (>= 1.6, < 2)
       logger (>= 1.4.2)
-      minitest (>= 5.1)
-      mutex_m
+      minitest (>= 5.1, < 6)
       securerandom (>= 0.3)
-      tzinfo (~> 2.0)
+      tzinfo (~> 2.0, >= 2.0.5)
     addressable (2.8.7)
       public_suffix (>= 2.0.2, < 7.0)
     amazing_print (1.6.0)
@@ -183,11 +177,8 @@ GEM
     method_source (1.1.0)
     mini_mime (1.1.5)
     mini_portile2 (2.8.9)
-    minitest (6.0.6)
-      drb (~> 2.0)
-      prism (~> 1.5)
+    minitest (5.27.0)
     msgpack (1.7.2)
-    mutex_m (0.3.0)
     net-imap (0.6.2)
       date
       net-protocol
@@ -245,20 +236,20 @@ GEM
       rack (>= 1.3)
     rackup (2.3.1)
       rack (>= 3)
-    rails (7.1.6)
-      actioncable (= 7.1.6)
-      actionmailbox (= 7.1.6)
-      actionmailer (= 7.1.6)
-      actionpack (= 7.1.6)
-      actiontext (= 7.1.6)
-      actionview (= 7.1.6)
-      activejob (= 7.1.6)
-      activemodel (= 7.1.6)
-      activerecord (= 7.1.6)
-      activestorage (= 7.1.6)
-      activesupport (= 7.1.6)
+    rails (7.2.3.2)
+      actioncable (= 7.2.3.2)
+      actionmailbox (= 7.2.3.2)
+      actionmailer (= 7.2.3.2)
+      actionpack (= 7.2.3.2)
+      actiontext (= 7.2.3.2)
+      actionview (= 7.2.3.2)
+      activejob (= 7.2.3.2)
+      activemodel (= 7.2.3.2)
+      activerecord (= 7.2.3.2)
+      activestorage (= 7.2.3.2)
+      activesupport (= 7.2.3.2)
       bundler (>= 1.15.0)
-      railties (= 7.1.6)
+      railties (= 7.2.3.2)
     rails-dom-testing (2.3.0)
       activesupport (>= 5.0.0)
       minitest
@@ -266,11 +257,11 @@ GEM
     rails-html-sanitizer (1.7.1)
       loofah (~> 2.25, >= 2.25.2)
       nokogiri (>= 1.15.7, != 1.16.7, != 1.16.6, != 1.16.5, != 1.16.4, != 1.16.3, != 1.16.2, != 1.16.1, != 1.16.0.rc1, != 1.16.0)
-    railties (7.1.6)
-      actionpack (= 7.1.6)
-      activesupport (= 7.1.6)
+    railties (7.2.3.2)
+      actionpack (= 7.2.3.2)
+      activesupport (= 7.2.3.2)
       cgi
-      irb
+      irb (~> 1.13)
       rackup (>= 1.0.0)
       rake (>= 12.2)
       thor (~> 1.0, >= 1.2.2)
@@ -390,6 +381,7 @@ GEM
       execjs (>= 0.3.0, < 3)
     unicode-display_width (2.5.0)
     uri (1.1.1)
+    useragent (0.16.11)
     webdrivers (5.3.0)
       nokogiri (~> 1.6)
       rubyzip (>= 1.3.0)
@@ -434,7 +426,7 @@ DEPENDENCIES
   pry-rails
   pry-rescue
   puma (~> 6.0)
-  rails (~> 7.1.0)
+  rails (>= 7.2.3.2, < 7.3)
   rbs
   react_on_rails!
   rspec-rails

data/Steepfile

@@ -43,6 +43,7 @@ target :lib do
   check "lib/react_on_rails/typescript_response_types/generated_file_writer.rb"
   check "lib/react_on_rails/utils.rb"
   check "lib/react_on_rails/version_checker.rb"
+  check "lib/react_on_rails/version_checker/lockfile_resolution.rb"
 
   # Specify RBS signature directories
   signature "sig"

data/docs/agent/install-and-upgrade.md

@@ -25,9 +25,11 @@ SHAKAPACKER_VERSION="$(bundle exec ruby -rreact_on_rails -e 'print ReactOnRails:
 bundle add shakapacker --version="${SHAKAPACKER_VERSION}" --strict
 ```
 
-For `--pro` or `--rsc`, React on Rails Pro is free for evaluation and non-production use;
-production use requires a subscription. Review [Pro licensing and setup](https://reactonrails.com/docs/pro/upgrading-to-pro/)
-before proceeding.
+For `--pro` or `--rsc`, React on Rails Pro is free in development, test, CI, and staging,
+and in production for small organizations, charities, schools, and hospitals;
+larger organizations subscribe ($1,800 per year per organization).
+No license key is needed to run Pro. Review [pricing](https://reactonrails.com/pricing/)
+and [Pro setup](https://reactonrails.com/docs/pro/upgrading-to-pro/) before proceeding.
 
 Skip this Pro-gem preparation for `--standard-only`.
 For `--pro` or `--rsc` only, derive the exact installed base-gem version before adding the Pro gem:
@@ -89,6 +91,9 @@ Review the generated initializer, Shakapacker configuration, scripts, routes, an
    `https://github.com/shakacode/react_on_rails/tree/v<GEM_TARGET_VERSION>`. Compare the complete
    `CURRENT_VERSION..GEM_TARGET_VERSION` release range before changing dependencies:
    `https://github.com/shakacode/react_on_rails/compare/v<CURRENT_VERSION>...v<GEM_TARGET_VERSION>`.
+   For Pro apps, treat `ReactOnRailsProHelper` methods as internal rather than stable extension points. If the app
+   prepends or overrides a Pro helper, compare its method signature between the exact tags and update the override
+   before running streamed SSR or RSC tests.
 
 ## JavaScript target matrix
 

data/docs/agent/rsc-adoption.md

@@ -25,6 +25,9 @@ bundle exec rake react_on_rails:install_rsc_agent_guardrails
 bin/rails react_on_rails:doctor FORMAT=json
 ```
 
+The generated advisory hook requires Claude Code 2.1.139 or newer. That release added the exec-form
+`args` field that keeps project paths with spaces or special characters intact.
+
 Before completion, protect any RSC payload route, keep the Node renderer private, avoid sensitive
 logged props or URLs, build all three bundles, and exercise navigation and hydration in a browser.
 

data/lib/generators/react_on_rails/base_generator.rb

@@ -904,7 +904,8 @@ module ReactOnRails
       end
 
       def home_page_pro_note_for_oss_app
-        "Review the Pro docs and upgrade guide first, then enable it with the appropriate license when you're ready."
+        "Review the Pro docs and upgrade guide first, then enable it when you're ready; " \
+          "a license key is optional and only marks your pages Licensed."
       end
 
       def preferred_rspec_helper_file

data/lib/generators/react_on_rails/generated_webpack_config_pair.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+require "erb"
+
+module ReactOnRails
+  module Generators
+    # Recognizes whole current generated pairs without interpreting application JavaScript.
+    # Every interpolation comes from these fixed variants, never from the input files.
+    class GeneratedWebpackConfigPair
+      TEMPLATE_ROOT = File.expand_path("templates/base/base/config/webpack", __dir__)
+      FILENAMES = %w[serverWebpackConfig.js ServerClientOrBoth.js].freeze
+      DOCUMENTATION_MESSAGE = "// The source code including full typescript support is available at:"
+      # pro, rsc, rspack: the latter affects source text only when RSC is enabled.
+      MODES = [[false, false, false], [true, false, false], [true, true, false], [true, true, true]].freeze
+
+      def self.pro_upgrade(contents)
+        shakapacker_versions = [false, true]
+        MODES.each do |pro, rsc, rspack|
+          shakapacker_versions.each do |shakapacker9|
+            pair = new(pro:, rsc:, rspack:, shakapacker9:)
+            next unless pair.contents == contents
+
+            return contents if pro
+
+            return new(pro: true, rsc:, rspack:, shakapacker9:).contents
+          end
+        end
+        nil
+      rescue StandardError, SyntaxError
+        # Missing templates or a newly introduced ERB dependency make recognition unknown.
+        # No input file has been touched; the caller supplies manual migration instructions.
+        nil
+      end
+
+      def initialize(pro:, rsc:, rspack:, shakapacker9:)
+        @pro = pro
+        @rsc = rsc
+        @rspack = rspack
+        @shakapacker9 = shakapacker9
+      end
+
+      def contents
+        FILENAMES.map do |filename|
+          template = File.read(File.join(TEMPLATE_ROOT, "#{filename}.tt"))
+          ERB.new(template, trim_mode: "-").result(template_binding).b
+        end
+      end
+
+      private
+
+      def template_binding
+        binding
+      end
+
+      def config
+        { message: DOCUMENTATION_MESSAGE }
+      end
+
+      def add_documentation_reference(message, source)
+        "#{message}\n#{source}"
+      end
+
+      def use_pro?
+        @pro
+      end
+
+      def use_rsc?
+        @rsc
+      end
+
+      def shakapacker_version_9_or_higher?
+        @shakapacker9
+      end
+
+      def rsc_plugin_class_name
+        @rspack ? "RSCRspackPlugin" : "RSCWebpackPlugin"
+      end
+
+      def rsc_plugin_import_path
+        @rspack ? "react-on-rails-rsc/RspackPlugin" : "react-on-rails-rsc/WebpackPlugin"
+      end
+    end
+  end
+end

data/lib/generators/react_on_rails/generator_helper.rb

@@ -486,10 +486,8 @@ module GeneratorHelper
     match = react_version.match(/(\d+)\.(\d+)\.(\d+)(?:[-.]([0-9A-Za-z.-]+))?/)
     return nil unless match
 
-    return nil unless Gem::Version.correct?(match[0])
-
-    # Preserve prerelease identifiers so callers can distinguish stable releases.
-    match[0]
+    # Return the matched version (without pre-release suffix for comparison)
+    "#{match[1]}.#{match[2]}.#{match[3]}"
   rescue StandardError
     nil
   end

data/lib/generators/react_on_rails/generator_messages.rb

@@ -7,7 +7,7 @@ require_relative "generator_messages/ci_section"
 require_relative "generator_messages/shakapacker_status_section"
 
 module GeneratorMessages
-  PRO_UPGRADE_HINT = "\n\n    💎 For RSC, streaming SSR, and 10-100x faster SSR, try React on Rails Pro:" \
+  PRO_UPGRADE_HINT = "\n\n    💎 For RSC, streaming SSR, and a dedicated Node renderer, try React on Rails Pro:" \
                      "\n       #{Rainbow('https://reactonrails.com/docs/pro/upgrading-to-pro/').cyan.underline}".freeze
   # Package manager constants and detection helpers live in PackageManagerDetection,
   # re-exported here for backwards compatibility (external callers use ::SUPPORTED_PACKAGE_MANAGERS).

data/lib/generators/react_on_rails/install_generator.rb

@@ -247,7 +247,8 @@ module ReactOnRails
         validate_product_stack_choice!
         return if options.new_app? || explicit_product_stack_choice? || !interactive_install_session?
 
-        say "React on Rails Pro is free for evaluation; production use requires a subscription."
+        say "No license key is needed to run Pro. Production is free for small organizations, charities, schools, " \
+            "and hospitals; larger organizations subscribe: https://reactonrails.com/pricing/"
         say "Learn more: https://reactonrails.com/docs/pro/upgrading-to-pro/"
         answer = ask(
           "Enable React on Rails Pro features (Node Renderer and streaming SSR; RSC available separately)? [Y/n]",

data/lib/generators/react_on_rails/js_dependency_manager.rb

@@ -138,30 +138,30 @@ module ReactOnRails
       ].freeze
 
       # React on Rails Pro dependencies (only installed when --pro or --rsc flag is used)
-      # These packages are published publicly on npmjs.org but require a license for production use
+      # Public npm packages with free production use for eligible organizations; see https://reactonrails.com/pricing/
       PRO_DEPENDENCIES = %w[
         react-on-rails-pro
         react-on-rails-pro-node-renderer
       ].freeze
 
       # React Server Components dependencies (only installed when --rsc flag is used)
-      # Requires React 19.2.x with patch >= 19.2.8 - see https://react.dev/reference/rsc/server-components
+      # Requires React 19.2.x with patch >= 19.2.7 - see https://react.dev/reference/rsc/server-components
       RSC_DEPENDENCIES = %w[
         react-on-rails-rsc
       ].freeze
 
       # React peer-dependency range for generated RSC apps. This governs the `react` / `react-dom`
       # installs (see add_react_dependencies) and intentionally stays on the React 19.2.x line
-      # with a 19.2.8 minimum. Do not widen this to later minors just because those releases are
+      # with a 19.2.7 minimum. Do not widen this to later minors just because those releases are
       # current on npm; React's RSC runtime and bundler integration can change between minors.
       #
       # This is intentionally distinct from RSC_PACKAGE_VERSION_PIN below, which pins
       # `react-on-rails-rsc`. Coordination note for #3609: Pro package metadata and generated apps
-      # use the tested React 19.2.x range with the exact RSC package pin.
-      RSC_REACT_VERSION_RANGE = "~19.2.8"
-      # Qualify the side-effect-only client module and CSS wrapper fixes during the 19.3.0 RC soak.
-      # Keep the React 19.2 runtime line independent from the RSC package minor.
-      RSC_PACKAGE_VERSION_PIN = "19.3.0-rc.4"
+      # use the tested React 19.2.x range with the exact stable RSC package pin.
+      RSC_REACT_VERSION_RANGE = "~19.2.7"
+      # Pinned to the stable 19.2.1 package, which carries the coordinated React 19.2.7 RSC peer floor
+      # required by the React on Rails Pro 17 runtime check.
+      RSC_PACKAGE_VERSION_PIN = "19.2.1"
 
       private
 
@@ -255,7 +255,7 @@ module ReactOnRails
         say "Installing React dependencies..."
 
         # RSC requires the coordinated React 19.2.x patch line.
-        # Pin React to ~19.2.8 while using the matching stable RSC package.
+        # Pin React to ~19.2.7 while using the matching stable RSC package.
         react_deps = if respond_to?(:use_rsc?) && use_rsc?
                        ["react@#{RSC_REACT_VERSION_RANGE}", "react-dom@#{RSC_REACT_VERSION_RANGE}",
                         "prop-types@^15.0.0"]
@@ -451,8 +451,8 @@ module ReactOnRails
         if rsc_package_version_prerelease?
           "React Server Components package pin: all --rsc installs temporarily use " \
             "react-on-rails-rsc@#{RSC_PACKAGE_VERSION_PIN}, including Webpack projects. " \
-            "This prerelease includes the qualified client-export parsing fixes and " \
-            "react-on-rails-rsc/RspackPlugin splitChunks fix. Keep the pin until stable " \
+            "This prerelease keeps react-on-rails-rsc/WebpackPlugin compatible while adding " \
+            "react-on-rails-rsc/RspackPlugin. Keep the pin until stable " \
             "react-on-rails-rsc@#{rsc_stable_package_version_target} " \
             "is published and tagged latest."
         else
@@ -466,9 +466,9 @@ module ReactOnRails
       def rsc_dependency_pin_failed_warning
         if rsc_package_version_prerelease?
           "Warning: Could not install the pinned react-on-rails-rsc@#{RSC_PACKAGE_VERSION_PIN}. " \
-            "All RSC projects are temporarily pinned to that version for its client-export parsing " \
-            "and react-on-rails-rsc/RspackPlugin splitChunks fixes. The unversioned `latest` tag " \
-            "does not include these fixes until stable " \
+            "All RSC projects are temporarily pinned to that version: the prerelease keeps " \
+            "react-on-rails-rsc/WebpackPlugin compatible while adding react-on-rails-rsc/RspackPlugin, " \
+            "and the unversioned `latest` tag may not include both until stable " \
             "#{rsc_stable_package_version_target} " \
             "is published, so the generator left the version pin in package.json rather than " \
             "install a potentially incompatible version."

data/lib/generators/react_on_rails/pro/USAGE

@@ -10,12 +10,23 @@ Example:
     - Node renderer process to Procfile.dev
 
 Modifies:
-    - config/webpack/serverWebpackConfig.js (enables Pro settings: libraryTarget,
-      target, extractLoader, Babel SSR caller, object exports)
-    - config/webpack/ServerClientOrBoth.js (switches to destructured import)
     - package.json (replaces react-on-rails with react-on-rails-pro and
       react-on-rails-pro-node-renderer)
 
+Bundler configuration:
+    Upgrades serverWebpackConfig.js and ServerClientOrBoth.js in the active
+    config/webpack/ or config/rspack/ directory only when both files exactly
+    match a supported current generated pair. Enables Pro server settings,
+    extractLoader, Babel SSR caller handling, and matching exports/imports.
+    A supported pair using the legacy companion filename generateWebpackConfigs.js
+    keeps that filename; it is not renamed.
+
+    Customized, unknown, unsupported historical, incomplete, or ambiguous pairs
+    are left unchanged, including their paths. If the pair is skipped, complete
+    the manual migration before building and verifying SSR; rerunning the
+    generator does not migrate these files:
+    https://reactonrails.com/docs/pro/upgrading-to-pro/#complete-a-skipped-webpackrspack-migration-manually
+
 Prerequisites:
     - React on Rails must be installed (rails g react_on_rails:install)
     - react_on_rails_pro gem must be in your Gemfile

data/lib/generators/react_on_rails/pro_generator.rb

@@ -951,7 +951,7 @@ module ReactOnRails
 
         GeneratorMessages.add_info(<<~MSG)
           Next steps:
-          1. Set your license: export REACT_ON_RAILS_PRO_LICENSE=your_token
+          1. Optional: set the license key from your subscription: export REACT_ON_RAILS_PRO_LICENSE=your_key
           2. Start the app: bin/dev (or foreman start -f Procfile.dev)
           3. Visit http://localhost:3000/#{route}
           4. The Node Renderer will start on port 3800