React on Rails, Shakapacker, E2E on Rails, Control Plane Flow
React on Rails, Shakapacker, and E2E on Rails are MIT. Control Plane Flow is LGPL 3.0. Use them anywhere, at any organization size.
Ambitious AI building, with proof
Build ambitious Rails + React apps with AI. Prove every improvement.
Give coding agents a public Rails 8 + React 19 foundation instead of a blank prompt. Use ShakaPerf to measure each optimization and keep only changes it proves faster and visually stable.
the_shaka_stack.rb▟ build → deploy
BuildReact on Rails01
BundleShakapacker02
TestE2E on Rails03
ProveShakaPerf04
DeployControl Plane Flow05
The problem
AI can write the code. How do you know it made the app better?
Ambitious changes cross rendering, data, bundles, browser behavior, and deployment. Without conventions and measurement, speed becomes guesswork.
01
Agents need a map
Blank-prompt code drifts. Conventions, typed boundaries, working examples, and repository instructions keep ambitious changes coherent.
02
Modern React crosses layers
RSC, streaming, data loading, browser tests, bundles, and deploys all have to work as one Rails application.
03
Faster needs proof
A change is not an improvement until repeatable measurements show it is faster and visual checks show it is still correct.
Let agents move fast. Keep Rails in charge. Require proof before a performance change survives.
Your guide
Maintainers with a public track record.
ShakaCode has worked on Rails + React systems since 2011 and maintains projects with more than 23 million combined gem downloads. Try the software, read the source, and judge the work before you buy anything.
12.5M+ React on Rails gem downloads React on Rails on RubyGems
11.4M+ Shakapacker gem downloads Shakapacker on RubyGems
Start with the code
Clone the Rails + React starter.
Give an agent a working architecture, explicit guardrails, and examples it can extend. Or open the live deployment to see the result first.
Clone a working Rails + React app
The public Rails 8 starter combines React on Rails Pro, React 19, supported GA React Server Components, streaming, and TanStack Router, Query & Table. Its shared shadcn/ui layer provides buttons, dialogs, inputs, tables, tabs, and toasts styled with Tailwind CSS.
Rails stays the application boundary. Add the React and TanStack pieces you need without adding a second server tier.
Clone the starter
View the live demo
TanStack Router guide
TanStack Query guide
shadcn/ui
Read its AGENTS.md
Rails 8React on Rails ProTanStack RouterTanStack QueryTanStack Tableshadcn/uiRSC showcase
The toolkit
Give your agents a proven Rails + React toolkit.
React on Rails and Shakapacker build. E2E on Rails tests behavior. ShakaPerf proves performance and visual stability. Control Plane Flow deploys. Every project includes public source or docs an agent can read.
01BuildRender React in Rails and bundle assets.
02TestExercise real browser flows with Rails test state.
03ProveCompare control and experiment before changes ship.
04DeployShip the validated app to production.
React on Rails
Bring React 19 and modern rendering to Rails.
Start with the MIT-licensed React on Rails 17.0.0 core for components, server rendering, and hydration. When you need more, React on Rails Pro adds supported GA React Server Components, streaming SSR, fragment caching, and a dedicated Node renderer without forcing Rails behind a separate frontend app.
Keep Rails in chargeRender React from Rails views and controllers while keeping your routes, domain logic, and conventions.
Start open sourceUse the MIT-licensed core for Rails + React integration, hydration, and server rendering.
Upgrade when it earns its placeAdd Pro for GA RSC, streaming, caching, and advanced rendering when your application needs them.
$bundle exec rails generate react_on_rails:install
$npx create-react-on-rails-app@latest my-app
Developer experience
Mix the best of Rails and React. Stay flexible.
Keep Rails' conventions and productivity. Add React 19, RSC, and the TanStack libraries where they make the product better.
Already have Rails?
Add TanStack incrementally
Add React on Rails Pro and the TanStack libraries you want to the app you already have. Keep your routes, conventions, and team while adopting the UI page by page.
- Adopt it page by page, alongside your existing Rails views
- Use SSR, hydration, and streaming where they earn their place
- Choose Query, Router, and Table independently
Starting fresh?
Spin up with full flexibility
Begin a new Rails app and mix exactly what you want, per page: classic Rails views, React on Rails components, React 19 + RSC, and TanStack. Use as much or as little as you need.
- Classic Rails, React components, RSC, or TanStack - your call
- The official starter gives you a deployable baseline on day one
- Scale from a sprinkle of React to a full TanStack app
Agent-ready
Give agents a real codebase and a measurable goal.
Rails conventions, typed contracts, and the starter's AGENTS.md let agents build ambitious features without starting from a blank prompt. Humans still own product decisions and review.
ShakaPerf closes the loop: agents iterate, and only changes verified faster and visually stable are kept.
…and all the great things about Rails
ActiveRecordMigrationsBackground jobsMailersSessions & authCSRF protectionConvention over configurationThe gem ecosystem
What it costs
Free to build. Paid only when a larger company runs Pro or ShakaPerf in production.
Every piece of the stack is free to read, install, and evaluate. Two products carry a trust-based commercial license; the rest is open source.
React on Rails Pro
Free in development, test, CI, and staging for everyone, and free in production for organizations under 10 people, $1M revenue, and $1M raised, plus charities, schools, and hospitals at any size. Larger organizations subscribe: $1,800 per year covers the whole organization, every app and developer. No license key is needed to run it.
ShakaPerf
Free for small organizations and free uses, including CI, PR checks, and coding-agent workflows. Larger organizations subscribe for production use.
No keys, no activation, nothing phones home. Whether you owe a subscription is a good-faith call your organization makes, and terms never tighten on a version you already have.
See it running
See what the projects can build.
Open a live demo, inspect its public source, or fork the starter.
Flagship
Flagship
Flagship
Official
Production
Legacy Tutorial App
The original full-app React on Rails tutorial, using Shakapacker with server rendering.
React on RailsShakapackerSSR
Demo unavailable Source
More React on Rails demos at reactonrails.com/examples →
Built by ShakaCode
Build first. Talk when it’s useful.
The starter, demos, source, and docs are public. If advanced rendering or production help earns a place in your project, React on Rails Pro and the maintainers are there.