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/devAlready on OSS? Start with the comparison guide, then use the upgrade guide if you need Pro.
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 appCompare OSS and Pro first, then upgrade only when higher-throughput SSR, RSC, or support is worth it.
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. Compare first, then add it when the extra SSR throughput or guided support matters.
bundle add react_on_rails_proOpen the upgrade guideOSS to Pro
Start here if you already run the OSS product and want to know whether the upgrade is justified.
Open the comparison guideOnce the comparison says Pro is worth it, follow the upgrade guide and add the Pro package.
Open the upgrade guideMigration
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.