Starting a new Rails + React app
Use the CLI to scaffold a working app, then customize from a clean baseline.
Create a new app
One product, two tiers: OSS and Pro
One recommended path to start. Branch into SSR, streaming, RSC, or Pro when you need them.
Recommended first run
npx create-react-on-rails-app@latest my-appcd my-appbin/rails db:preparebin/devNot starting fresh? See the install, migration, or Pro upgrade guides below.
Choose your situation
Use the CLI to scaffold a working app, then customize from a clean baseline.
Create a new appInstall React on Rails into your existing app and render components without rebuilding the stack.
Install into an existing appSee what Pro adds, how the upgrade works, and where higher-throughput SSR or RSC support fits.
Compare OSS and ProBrowse example apps and migration paths from react-rails or vite_rails.
See examplesRecommended flow
One command to a working app. Customize after.
npx create-react-on-rails-app@latest my-appFollow the new-app guideAdd React on Rails to your existing codebase. Keep your routes, add components incrementally.
bundle exec rails generate react_on_rails:install --typescriptUse the install guidePro 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 pathMigration
Step-by-step checklist for swapping `react-rails` to React on Rails, with a sample app.
Open guideWorking repositories showing SSR, migration, and integration patterns.
Open guideIn production
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.
Expert help
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.