react-on-rails-pro

The client-side JavaScript package for React on Rails Pro. This package replaces the base react-on-rails package and re-exports everything from it, plus Pro-exclusive features like React Server Components support.

Installation

npm install react-on-rails-pro
# or
yarn add react-on-rails-pro
# or
pnpm add react-on-rails-pro

Important: When using the react_on_rails_pro Ruby gem, you must use this package (react-on-rails-pro) instead of react-on-rails. If the Pro gem detects the base react-on-rails npm package at runtime, it will raise an error.

React on Rails Pro uses ShakaCode Trust-Based Commercial Licensing: it is free to evaluate in development, CI/CD, and staging, and a paid license is required only for production deployments.

Usage

Component Registration

// Import from react-on-rails-pro (NOT react-on-rails)
import ReactOnRails from 'react-on-rails-pro';

import MyComponent from './MyComponent';

// Register components for use in Rails views
ReactOnRails.register({ MyComponent });

React Server Components (Pro-exclusive)

import RSCRoute from 'react-on-rails-pro/RSCRoute';
import registerServerComponent from 'react-on-rails-pro/registerServerComponent/client';
import wrapServerComponentRenderer from 'react-on-rails-pro/wrapServerComponentRenderer/client';

// Register a server component for client-side hydration
registerServerComponent('MyServerComponent');

Package Relationship

react-on-rails-pro (this package)
└── react-on-rails (base package, automatically installed as dependency)

This package wraps and extends the base react-on-rails package. You only need to install react-on-rails-pro — the base package is included as a dependency.

What this package adds over react-on-rails

• React Server Components support (RSCRoute, RSCProvider, registerServerComponent)
• Server component renderer wrapping (wrapServerComponentRenderer)
• Conditional exports for react-server and node environments
• Seamless integration with the react_on_rails_pro Ruby gem

Exports

Rails-Side Setup

This npm package works with the react_on_rails_pro Ruby gem:

# Gemfile
gem "react_on_rails_pro"

Or use the generator for automated setup:

rails generate react_on_rails:install --pro

See the full installation guide.

Documentation

• Installation Guide
• Configuration Reference
• React Server Components Tutorial
• Upgrade from OSS to Pro
• React on Rails Pro Overview

License

Commercial software under ShakaCode Trust-Based Commercial Licensing. No license token is required for evaluation, development, testing, or CI/CD. A paid license is required for production deployments. Contact ShakaCode for licensing.