Skip to main content
React on Rails logo
React on Rails

Official documentation for one product with two tiers

React on Rails keeps Rails conventions and adds modern React.

Start with one recommended path, then branch into SSR, streaming, RSC, migration, or Pro only when you need them.

Start with the docsReview examplesUnderstand Pro

Recommended first run

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

If you are not starting fresh, the docs route you into existing-app install, migration, or Pro upgrade paths instead.

Choose your path

Docs should start from your situation, not from our internal file layout.

Persona A

Starting a new Rails + React app

Use the CLI-backed happy path, get to a working app quickly, and customize from a clean baseline.

Create a new app

Persona B

Adding React to an existing Rails app

Keep the Rails app you already have, install React on Rails, and render components without rebuilding the stack.

Install into an existing app

Persona C

Already on OSS and need more performance

See what Pro adds, how the upgrade works, and where higher-throughput SSR or RSC support fits.

Compare OSS and Pro

Persona D

Evaluating Rails + React options

Review example apps, migration references, and concrete paths from react-rails or vite_rails.

Evaluate the ecosystem fit

Recommended flow

Keep the first-run path obvious. Put alternatives behind it, not in front of it.

Recommended for new projects

Start with one working path before you branch into deeper configuration.

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

For mature Rails apps

Install React on Rails into an existing codebase, keep your routes, and 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 tier, 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 and evaluation

Modern docs need concrete migration routes, not generic reassurance.

Migrate from react-rails

Swap from `react-rails` to React on Rails with a migration checklist grounded in a real sample app.

Open guide

Browse sample apps

Open repositories that show canonical SSR, migration, and evaluation workflows without marketing detours.

Open guide

Production feedback

React on Rails Pro is an upgrade tier for teams that need more, not a separate ecosystem.

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