React, Redux, Tailwind CSS, React Server Components, ES2024, Rspack, Ruby on Rails Demo

• Server-Side Rendering and React Server Components via React on Rails Pro with the Node Renderer
• Live at www.reactrails.com

Control Plane Deployment Example

Control Plane offers a viable, cost-saving alternative to Heroku, especially when using the cpflow gem to deploy to Control Plane.

ShakaCode recently migrated HiChee.com to Control Plane, resulting in a two-thirds reduction in server hosting costs!

See ./.controlplane/readme.md for local cpflow setup plus the shared cpflow-* GitHub Actions flow for review apps, automatic staging deploys, and manual promotion to production.

The instructions leverage the cpflow CLI, with source code and many more tips on how to migrate from Heroku to Control Plane in https://github.com/shakacode/heroku-to-control-plane.

---

React on Rails Pro and ShakaCode Pro Support

React on Rails Pro provides Node server rendering and other performance enhancements for React on Rails.

• HVMN Testimonial, Written by Paul Benigeri, October 12, 2018
• HVMN’s 90% Reduction in Server Response Time from React on Rails Pro
• Egghead React on Rails Pro Deployment Highlights

For more information, see the React on Rails Pro Docs.

• Optimizing your front-end setup with Rspack + Shakapacker for React on Rails, including SSR and code splitting.
• Upgrading your app to the current React on Rails 16.4 / Shakapacker 9.7 stack with modern asset builds.
• Better performance client and server side.

ShakaCode can also help you with your custom software development needs. We specialize in marketplace and e-commerce applications that utilize both Rails and React. We can even leverage our code for HiChee.com for your app!

See the ShakaCode Client Engagement Model article to learn how we can work together.

---

Community

• forum.shakacode.com: Post your questions
• @railsonmaui on Twitter
• For a live, example of the code in this repo, see www.reactrails.com.

---

Testimonials

From Joel Hooks, Co-Founder, Chief Nerd at egghead.io, January 30, 2017:

For more testimonials, see Live Projects and Kudos.

---

Videos

React On Rails Tutorial Series

1. History and Motivation
2. Basic Tutorial Walkthrough
3. Code Walkthrough

NEWS

• 2022-01-11: Added example of deployment to the ControlPlane.

You can see this tutorial live here: http://reactrails.com/

Table of Contents

• Demoed Functionality
  • Technologies Involved
• Basic Demo Setup
  • Basic Command Line
• Javascript Development without Rails
• Rails Integration
• Rspack
  • Configuration Files
  • Additional Resources
• React Server Components (RSC)
• Thruster HTTP/2 Proxy
• Sass, CSS Modules, and Tailwind CSS integration
  • Fonts with SASS
• Process Management during Development
• Contributors
  • About ShakaCode
  • RubyMine and WebStorm
• Open Code of Conduct

Demoed Functionality

• Example of using React on Rails Pro with the Node Renderer for server-side rendering and React Server Components.
• Example of React Server Components with streaming, Suspense fallbacks, error boundaries, and client-driven re-fetching — see the /server-components page.
• Example of 'use client' directives splitting a tree between server-rendered and client-hydrated components (the "donut pattern").
• Example of using the react_on_rails gem (via React on Rails Pro) for React + Rspack integration with Rails.
• Example of React with CSS Modules inside Rails using modern Shakapacker/Rspack builds.
• Example of enabling hot reloading of both JS and CSS (modules) from your Rails app in development mode. Change your code. Save. Browser updates without a refresh!
• Example of React/Redux with Rails Action Cable.
• Example of Rails 8 with ReactJs/Redux/React-Router with Rspack and modern JavaScript.
• Enabling development of a JS client independently from Rails using the Rspack dev server. You can see this by starting the app and visiting http://localhost:4000
• Enabling the use of npm modules and Babel with a Rails application using Rspack.
• Easily enable retrofitting such a JS framework into an existing Rails app. You don't need a brand new single page app!
• Example setting up Ruby and JavaScript linting in a real project, with corresponding CI rake tasks.
• Enabling the i18n functionality with react-intl.

Technologies involved

See package.json and Gemfile for versions

1. React on Rails Pro with the Node Renderer for SSR and React Server Components
2. React 19 with React Server Components support
3. Redux
4. react-router
5. react-router-redux
6. Rspack with hot-reload (for local dev)
7. SWC transpiler for fast JavaScript/TypeScript compilation
8. Ruby on Rails 8 for backend app and comparison with plain HTML
9. Thruster - Zero-config HTTP/2 proxy for optimized asset delivery
10. Heroku deployment guide
11. Deployment to the ControlPlane
12. Tailwind CSS

Basic Demo Setup

Prerequisites

• Node v22.3.0 or above. Be sure that you have Node installed! We suggest using nvm and running nvm list to check the active Node version. See this article Updating and using nvm.
• Ruby 3.4.6 or above
• Postgres v9.2 or above
• Redis. Check that you have Redis installed by running which redis-server. If missing and on MacOS, install with Homebrew (brew install redis)
• Yarn.

Setup

1. git clone git@github.com:shakacode/react-webpack-rails-tutorial.git
2. cd react-webpack-rails-tutorial
3. bundle install
4. yarn
5. rake db:setup
6. rails start
   • Open a browser tab to http://localhost:3000 for the Rails app example

Basic Command Line

• Run all linters and tests: rake
• See all npm commands: yarn run
• To start all development processes: foreman start -f Procfile.dev
• To start only all Rails development processes: foreman start -f Procfile.hot

Javascript Development without Rails using the Rspack Dev Server

Start the full development stack with foreman start -f Procfile.dev, then open http://localhost:4000 to iterate on the JavaScript client with hot reloading.

Rails Integration

We're now using Rspack for all Sass and JavaScript assets so we can do CSS Modules within Rails!

• Production Deployment: heroku-deployment.md.
  • Configure Buildpacks

    heroku buildpacks:set heroku/ruby --app your-app
    heroku buildpacks:add --index 1 heroku/nodejs --app your-app
    heroku buildpacks:set --index 3 https://github.com/sreid/heroku-buildpack-sourceversion.git --app your-app
    

Testing

• See Yak Shaving Failing Integration Tests with React and Rails

• Be sure to see Integration Test Notes for advice on running your integration tests.

• Testing Mode: When running tests, it is useful to run foreman start -f Procfile.spec in order to have Rspack automatically recompile the static bundles. Rspec is configured to automatically check whether or not this process is running. If it is not, it will automatically rebuild the bundle to ensure you are not running tests on stale client code. This is achieved via the ReactOnRails::TestHelper.configure_rspec_to_compile_assets(config) line in the rails_helper.rb file. If you are using this project as an example and are not using RSpec, you may want to implement similar logic in your own project.

Rspack with Shakapacker

This project is standardized on Rspack with Shakapacker.

Bundler selection is fixed in config/shakapacker.yml:

assets_bundler: rspack

Version Targets

• react_on_rails_pro gem: 17.1.0
• react-on-rails-pro npm package: 17.1.0
• react-on-rails-pro-node-renderer npm package: 17.1.0
• react-on-rails-rsc npm package: 19.3.0
• shakapacker gem/npm package: 10.2.0
• @rspack/core and @rspack/cli: 2.0.4
• react, react-dom, and react-server-dom-webpack: 19.2.8 (exact RC validation pins)

Why Rspack

• Faster dev/test/prod compile times
• Better incremental rebuild performance for local development
• One bundler path for browser bundles and SSR bundles

Currently on webpack, temporarily. The repo is built on webpack instead of rspack while shakacode/react_on_rails_rsc#29 ships rspack support for the RSC plugin. Tracked as a TODO in config/shakapacker.yml; flips back once that lands.

Configuration Files

All bundler configuration is in config/webpack/:

• webpackConfig.js — Composer; produces all bundles (client + SSR + RSC)
• commonWebpackConfig.js — Shared base configuration
• clientWebpackConfig.js — Client bundle (browser, with HMR + RSC client-references)
• serverWebpackConfig.js — SSR bundle (runs in the Pro Node Renderer)
• rscWebpackConfig.js — React Server Components bundle (runs in the Pro Node Renderer with the react-server resolve condition)
• bundlerUtils.js — Bundler detection helper (webpack vs rspack)
• development.js, production.js, test.js — Environment-specific tweaks

Additional Resources

• Shakapacker Documentation
• Rspack Documentation

React Server Components (RSC)

This project demonstrates React Server Components running on top of the React on Rails Pro Node Renderer. With the dev stack running, visit /server-components to see the demo.

What the demo shows

How the build works

The app produces three bundles, all sharing the client/app/packs/server-bundle.js entry:

• Client bundle — Browser JavaScript with HMR; emits react-client-manifest.json for client-component resolution.
• SSR bundle — Traditional server-side rendering; runs in the Pro Node Renderer (port 3800).
• RSC bundle — RSC payload generation; runs in the Pro Node Renderer with the react-server resolve condition and an extra loader that classifies 'use client' modules as client references.

The three bundles are gated by env vars:

Procfile.dev runs three watchers (wp-client, wp-server, wp-rsc), each gated by its own env var, alongside the Rails server and the Pro Node Renderer.

Setup notes

In addition to the Basic Demo Setup prerequisites:

• A REACT_ON_RAILS_PRO_LICENSE environment variable. Development and test environments don't require one (the Pro engine logs an info-level notice instead). Production deploys must set it to a JWT from pro.reactonrails.com.
• RENDERER_PASSWORD (shared between Rails and the Node Renderer for SSR auth). The dev/test default is provided in .env.example; production must override.
• Optional: RSC_SUSPENSE_DEMO_DELAY=true adds a small artificial server delay so Suspense fallbacks are visible during the demo. Off by default; enabled on the QA review-app.

Further reading

• How React Server Components work — RoR Pro's RSC overview
• Preparing your app for RSC — 'use client' directive rules
• Component patterns — async server components and Suspense
• Data fetching — controller-props pattern (used by CommentsFeed)

Thruster HTTP/2 Proxy

This project uses Thruster, a zero-config HTTP/2 proxy from Basecamp, for optimized asset delivery and improved performance.

What Thruster Provides

• HTTP/2 Support: Automatic HTTP/2 with multiplexing for faster parallel asset loading
• Asset Caching: Intelligent caching of static assets from the public/ directory
• Compression: Automatic gzip/Brotli compression for reduced bandwidth usage
• Simplified Configuration: No need for manual early hints configuration
• Production Ready: Built-in TLS termination with Let's Encrypt support

Benefits

Compared to running Puma directly with --early-hints:

• 20-30% faster initial page loads due to HTTP/2 multiplexing
• 40-60% reduction in transfer size with Brotli compression
• Simpler setup - zero configuration required
• Better caching - automatic static asset optimization

Usage

Thruster is already integrated into all Procfiles:

# Development with HMR
foreman start -f Procfile.dev

# Production
web: bundle exec thrust bin/rails server

The server automatically benefits from HTTP/2, caching, and compression without any additional configuration.

For detailed information, troubleshooting, and advanced configuration options, see docs/thruster.md.

Sass, CSS Modules, and Tailwind CSS Integration

This example project uses mainly Tailwind CSS for styling. Besides this, it also demonstrates Sass and CSS modules, particularly for some CSS transitions.

We're using Rspack to handle Sass assets so that we can use CSS modules. The best way to understand how we're handling assets is to closely follow this example. We'll be working on more docs soon. If you'd like to give us a hand, that's a great way to learn about this!

For example in client/app/bundles/comments/components/CommentBox/CommentBox.jsx, see how we use standard JavaScript import syntax to refer to class names that come from CSS modules:

import css from './CommentBox.module.scss';

export default class CommentBox extends React.Component {
  render() {
    const { actions, data } = this.props;
    const cssTransitionGroupClassNames = {
      enter: css.elementEnter,
      enterActive: css.elementEnterActive,
      exit: css.elementLeave,
      exitActive: css.elementLeaveActive,
    };
  }
}

Fonts with SASS

The tutorial makes use of a custom font OpenSans-Light. We're doing this to show how to add assets for the CSS processing. The font files are located under client/app/assets/fonts and are loaded by both the Rails asset pipeline and the Rspack HMR server.

Process Management during Development

bundle exec foreman start -f <Procfile>

1. Procfile.dev: Starts the full development stack with Hot Reloading. Six processes:
   • rescript — ReScript watch mode
   • rails — Rails server via Thruster on port 3000
   • wp-client — Shakapacker dev server with HMR (client bundle)
   • wp-server — Shakapacker watcher for the SSR bundle
   • wp-rsc — Shakapacker watcher for the React Server Components bundle
   • node-renderer — React on Rails Pro Node Renderer on port 3800
2. Procfile.dev-static: Starts the Rails server and generates static assets that are used for tests.

Contributors

The Shaka Code team!, led by Justin Gordon, along with with many others. See contributors.md

RubyMine and WebStorm

Special thanks to JetBrains for their great tools: RubyMine and WebStorm. Some developers of this project use RubyMine at the top level, mostly for Ruby work, and we use WebStorm opened up to the client directory to focus on JSX and Sass files.

Hiring

We're looking for great developers that want to work with Rails + React (and react-native!) with a remote-first, distributed, worldwide team, for our own products, client work, and open source. More info here.

---

Thank you from Justin Gordon and ShakaCode

Thank you for considering using React on Rails.

Aloha and best wishes from the ShakaCode team!