Rails/Webpacker React Integration Options

You only need props hydration if you need SSR. However, there's no good reason to have your app make a second round trip to the Rails server to get initialization props.

Server-Side Rendering (SSR) results in Rails rendering HTML for your React components. The main reasons to use SSR are better SEO and pages display more quickly.

These gems provide advanced integration of React with rails/webpacker:

GemProps HydrationServer-Side-Rendering (SSR)SSR with HMRSSR with React-RouterSSR with Code SplittingNode SSR

Note, Node SSR for React on Rails requires React on Rails Pro.

As mentioned, you don't need to use a gem to integrate Rails with React.

If you're not concerned with view helpers to pass props or server rendering, can do it yourself:

<%# views/layouts/application.html.erb %>

<%= content_tag :div,
  id: "hello-react",
  data: {
    message: 'Hello!',
    name: 'David'
}.to_json do %>
<% end %>
// app/javascript/packs/hello_react.js

const Hello = props => (
  <div className='react-app-wrapper'>
    <img src={clockIcon} alt="clock" />
    <h5 className='hello-react'>
      {props.message} {props.name}!

// Render component with data
document.addEventListener('DOMContentLoaded', () => {
  const node = document.getElementById('hello-react')
  const data = JSON.parse(node.getAttribute('data'))

  ReactDOM.render(<Hello {...data} />, node)

HMR and React Hot Reloading

Before turning HMR on, consider upgrading to the latest stable gems and packages: https://github.com/rails/webpacker#upgrading

Configure config/webpacker.yml file:

  extract_css: false
    hmr: true
    inline: true

This basic configuration alone will have HMR working with the default webpacker setup. However, an code saves will trigger a full page refresh each time you save a file.

Webpack's HMR allows the replacement of modules for React in-place without reloading the browser. To do this, you have two options:

  1. Steps below for the github.com/pmmmwh/react-refresh-webpack-plugin.
  2. Deprecated steps below for using the github.com/gaearon/react-hot-loader.

React Refresh Webpack Plugin


You can see an example commit of adding this here.

  1. Add react refresh packages: yarn add @pmmmwh/react-refresh-webpack-plugin react-refresh -D

  2. Update babel.config.js adding

    plugins: [
      process.env.WEBPACK_DEV_SERVER && 'react-refresh/babel',
      // other plugins
  3. Update config/webpack/development.js, only including the plugin if running the WEBPACK_DEV_SERVER

    const ReactRefreshWebpackPlugin = require('@pmmmwh/react-refresh-webpack-plugin');
    const environment = require('./environment')
    const isWebpackDevServer = process.env.WEBPACK_DEV_SERVER;
    if (isWebpackDevServer) {
            new ReactRefreshWebpackPlugin({
                overlay: {
                    sockPort: 3035

React Hot Loader (Deprecated)

  1. Add the react-hot-loader and @hot-loader/react-dom npm packages.

    yarn add --dev react-hot-loader @hot-loader/react-dom
  2. Update your babel config, babel.config.js. Add the plugin react-hot-loader/babel with option "safetyNet": false:

    "plugins": [
            "safetyNet": false
  1. Add changes like this to your entry points:
// app/javascript/app.jsx

import React from 'react';
+ import { hot } from 'react-hot-loader/root';

const App = () => <SomeComponent(s) />

- export default App;
+ export default hot(App);
  1. Adjust your webpack configuration for development so that sourceMapContents option for the sass loader is false:
// config/webpack/development.js

process.env.NODE_ENV = process.env.NODE_ENV || 'development'

const environment = require('./environment')

// allows for editing sass/scss files directly in browser
+ if (!module.hot) {
+   environment.loaders.get('sass').use.find(item => item.loader === 'sass-loader').options.sourceMapContents = false
+ }
module.exports = environment.toWebpackConfig()
  1. Adjust your config/webpack/environment.js for a
// config/webpack/environment.js

// ...

// Fixes: React-Hot-Loader: react-🔥-dom patch is not detected. React 16.6+ features may not work.
// https://github.com/gaearon/react-hot-loader/issues/1227#issuecomment-482139583
+ environment.config.merge({ resolve: { alias: { 'react-dom': '@hot-loader/react-dom' } } });

module.exports = environment;