Skip to main content
React on Rails logo
React on Rails

OSS & Pro documentation

Rails conventions. Modern React.

One recommended path to start. Branch into SSR, streaming, RSC, or Pro when you need them.

Recommended first run

  1. npx create-react-on-rails-app@latest my-app
  2. cd my-app
  3. bin/rails db:prepare
  4. bin/dev

Not starting fresh? See the install, migration, or Pro upgrade guides below.

Getting started

Pick your starting point

Starting a new Rails + React app

Use the CLI to scaffold a working app, then customize from a clean baseline.

Create a new app

Adding React to an existing Rails app

Install React on Rails into your existing app and render components without rebuilding the stack.

Install into an existing app

Already on OSS and need more performance

Compare OSS and Pro features, and see when higher-throughput SSR or RSC support is worth the upgrade.

Compare OSS and Pro

Evaluating Rails + React options

Browse example apps and migration paths from react-rails or vite_rails.

See examples

Quick start

Three paths, one command each

Recommended for new projects

One command to a working app. Customize after.

npx create-react-on-rails-app@latest my-appFollow the new-app guide

For mature Rails apps

Add React on Rails to your existing codebase. Keep your routes, add components incrementally.

bundle exec rails generate react_on_rails:install --typescriptUse the install guide

When OSS is no longer enough

Pro is an upgrade, not a separate product. Add it when you need more SSR throughput or guided support.

bundle add react_on_rails_proReview the upgrade path

Migration

Move from another setup

Migrate from react-rails

Step-by-step checklist for swapping `react-rails` to React on Rails, with a sample app.

Open guide

Browse sample apps

Working repositories showing SSR, migration, and integration patterns.

Open guide

In production

Teams shipping with React on Rails

React on Rails lets us run React at scale inside Rails without the complexity of a separate frontend deployment. ShakaCode's implementation optimized the framework for our specific workload, delivering 97% Good LCP scores and 80% faster hydration across our platform.

Justis BlascoPopmenu

Expert help

Talk to the team behind React on Rails

ShakaCode maintains React on Rails and helps teams ship with SSR, RSC, and Rails integration. Book a free 30-minute call for architecture, performance, or migration advice.