react-on-rails - npm Package Versions

[15.0.0-rc.1] - 2025-06-18

Improved

• Ensured that the RSC payload is injected after the component's HTML markup to improve the performance of the RSC payload injection. PR 1738 by AbanoubGhadban.

[15.0.0-rc.0] - 2025-06-16

Improved

• Improved RSC rendering flow by eliminating double rendering of server components and reducing the number of HTTP requests.
• Updated communication protocol between Node Renderer and Rails to version 2.0.0 which supports the ability to upload multiple bundles at once.
• Added RSCRoute component to enable seamless server-side rendering of React Server Components. This component automatically handles RSC payload injection and hydration, allowing server components to be rendered directly within client components while maintaining optimal performance.

PR 1696 by AbanoubGhadban.

Added

• Configuration option generated_component_packs_loading_strategy to control how generated component packs are loaded. It supports sync, async, and defer strategies. PR 1712 by AbanoubGhadban.

• Support for returning React component from async render-function. PR 1720 by AbanoubGhadban.

Removed (Breaking Changes)

• Deprecated defer_generated_component_packs configuration option. You should use generated_component_packs_loading_strategy instead. PR 1712 by AbanoubGhadban.

Changed

• Breaking change: The package is ESM-only now. Please see Release Notes for more details.
• The global context is now accessed using globalThis. PR 1727 by alexeyr-ci2.
• Generated client packs now import from react-on-rails/client instead of react-on-rails. PR 1706 by alexeyr-ci.
  • The "optimization opportunity" message when importing the server-side react-on-rails instead of react-on-rails/client in browsers is now a warning for two reasons:
    • Make it more prominent
    • Include a stack trace when clicked

[15.0.0-alpha.2] - 2025-03-07

See Release Notes for full details.

Added

• React Server Components Support (Pro Feature) PR 1644 by AbanoubGhadban.
• Improved component and store hydration performance PR 1656 by AbanoubGhadban.

Breaking Changes

• ReactOnRails.reactOnRailsPageLoaded is now an async function
• force_load configuration now defaults to true
• defer_generated_component_packs configuration now defaults to false

[14.2.0] - 2025-03-03

Added

• Add export option 'react-on-rails/client' to avoid shipping server-rendering code to browsers (~5KB improvement) PR 1697 by Romex91.

Fixed

• Fix obscure errors by introducing FULL_TEXT_ERRORS PR 1695 by Romex91.
• Disable esModuleInterop to increase interoperability PR 1699 by alexeyr-ci.
• Resolved 14.1.1 incompatibility with eslint & made sure that spec/dummy is linted by eslint. PR 1693 by judahmeek.

Changed

• More up-to-date TS config PR 1700 by alexeyr-ci.

[14.1.1] - 2025-01-15

Fixed

• Separated streamServerRenderedReactComponent from the ReactOnRails object in order to stop users from getting errors during Webpack compilation about needing the stream-browserify package. PR 1680 by judahmeek.
• Removed obsolete js-yaml peer dependency. PR 1678 by alexeyr-ci.

[14.1.0] - 2025-01-06

Fixed

• Incorrect type and confusing name for ReactOnRails.registerStore, use registerStoreGenerators instead. PR 1651 by alexeyr-ci.
• Changed the ReactOnRails' version checker to use ReactOnRails.configuration.node_modules_location to determine the location of the package.json that the react-on-rails dependency is expected to be set by.
• Also, all errors that would be raised by the version checking have been converted to Rails.Logger warnings to avoid any breaking changes. PR 1657 by judahmeek.
• Enable use as a git: dependency. PR 1664 by alexeyr-ci.

Added

• Added streaming server rendering support:
  • PR #1633 by AbanoubGhadban.
    • New stream_react_component helper for adding streamed components to views
    • New streamServerRenderedReactComponent function in the react-on-rails package that uses React 18's renderToPipeableStream API
    • Enables progressive page loading and improved performance for server-rendered React components
  • Added support for replaying console logs that occur during server rendering of streamed React components. This enables debugging of server-side rendering issues by capturing and displaying console output on the client and on the server output. PR #1647 by AbanoubGhadban.
  • Added support for handling errors happening during server rendering of streamed React components. It handles errors that happen during the initial render and errors that happen inside suspense boundaries. PR #1648 by AbanoubGhadban.
  • Added support for passing options to YAML.safe_load when loading locale files with config.i18n_yml_safe_load_options. PR #1668 by dzirtusss.

Changed

• Console replay script generation now awaits the render request promise before generating, allowing it to capture console logs from asynchronous operations. This requires using a version of the Node renderer that supports replaying async console logs. PR #1649 by AbanoubGhadban.