Starting a new Rails + React app
Use the CLI to scaffold a working app, then customize from a clean baseline.
Create a new app
OSS & Pro documentation
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.
Getting started
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 features, and see when higher-throughput SSR or RSC support is worth the upgrade.
Compare OSS and ProBrowse example apps and migration paths from react-rails or vite_rails.
See examplesQuick start
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, 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.