Improve package metadata and Pro upgrade CTAs (#3112)

Improve RubyGems and npm package discovery so React on Rails users land
on the docs site and get a clearer, low-noise path to evaluate Pro. This
updates the OSS gem post-install message, points gem and npm
homepage/documentation metadata at `reactonrails.com`, and adds concise
README upgrade/trial links for the OSS and Pro npm packages. It also
adds package `repository.directory` metadata so npm package pages
resolve to the right folder in the monorepo.

~~- [ ] Add/update test to cover these changes~~
- [x] Update documentation
~~- [ ] Update CHANGELOG file~~

Validation included local RubyGems/npm install-message experiments,
`package.json` parsing, gemspec loading, and Prettier; RuboCop on the
gemspecs still reports the repo's existing
`Gemspec/DevelopmentDependencies` offenses.

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Low Risk**
> Low risk: changes are limited to package/gem metadata, README links,
and a post-install message, with no runtime logic impact aside from
updated gem dependencies ordering/metadata fields.
>
> **Overview**
> Updates npm packages (`react-on-rails`, `react-on-rails-pro`, and
`react-on-rails-pro-node-renderer`) to improve discoverability by adding
`repository.directory` metadata and pointing `homepage` links to
`reactonrails.com` docs.
>
> Refreshes documentation/CTAs: adds an OSS README section promoting Pro
with evaluation/licensing links, updates the Pro README to use the docs
site and include upgrade/trial messaging, and enhances both gemspecs
with richer RubyGems metadata plus an updated `react_on_rails`
post-install message directing users to Pro resources. (Also
reorders/adds Pro gem runtime dependency entries without changing
versions.)
>
> <sup>Reviewed by [Cursor Bugbot](https://cursor.com/bugbot) for commit
be7227c. Bugbot is set up for automated
code reviews on this repo. Configure
[here](https://www.cursor.com/dashboard/bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

* **Documentation**
* Updated documentation links across packages to point to the new
documentation portal.
* Added licensing clarification: React on Rails Pro is free for
evaluation in development, CI/CD, and staging environments; paid
licensing required only for production deployments.
* Enhanced README with information about React on Rails Pro features and
OSS vs. Pro comparison.

* **Chores**
* Updated package and gem metadata to include directory references and
point to the new documentation domain.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: justin808

packages/react-on-rails-pro-node-renderer/package.json

@@ -91,7 +91,8 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/shakacode/react_on_rails.git"
+    "url": "git+https://github.com/shakacode/react_on_rails.git",
+    "directory": "packages/react-on-rails-pro-node-renderer"
   },
   "keywords": [
     "react",
@@ -106,7 +107,7 @@
   "bugs": {
     "url": "https://github.com/shakacode/react_on_rails/issues"
   },
-  "homepage": "https://github.com/shakacode/react_on_rails/tree/main/packages/react-on-rails-pro-node-renderer#readme",
+  "homepage": "https://reactonrails.com/docs/pro/node-renderer/",
   "jest": {
     "clearMocks": true,
     "moduleNameMapper": {

packages/react-on-rails-pro/README.md

@@ -1,6 +1,6 @@
 # react-on-rails-pro
 
-The client-side JavaScript package for [React on Rails Pro](https://github.com/shakacode/react_on_rails). This package **replaces** the base `react-on-rails` package and re-exports everything from it, plus Pro-exclusive features like React Server Components support.
+The client-side JavaScript package for [React on Rails Pro](https://reactonrails.com/docs/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
 
@@ -14,6 +14,8 @@ 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 is free to evaluate in development, CI/CD, and staging. A paid license is required only for production deployments.
+
 ## Usage
 
 ### Component Registration
@@ -90,7 +92,8 @@ See the [full installation guide](https://reactonrails.com/docs/pro/installation
 - [Installation Guide](https://reactonrails.com/docs/pro/installation)
 - [Configuration Reference](https://reactonrails.com/docs/configuration/configuration-pro)
 - [React Server Components Tutorial](https://reactonrails.com/docs/pro/react-server-components/tutorial)
-- [React on Rails Pro Overview](https://pro.reactonrails.com/)
+- [Upgrade from OSS to Pro](https://reactonrails.com/docs/pro/upgrading-to-pro/)
+- [React on Rails Pro Overview](https://reactonrails.com/docs/pro/)
 
 ## License
 

packages/react-on-rails-pro/package.json

@@ -17,7 +17,8 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/shakacode/react_on_rails.git"
+    "url": "git+https://github.com/shakacode/react_on_rails.git",
+    "directory": "packages/react-on-rails-pro"
   },
   "keywords": [
     "react",
@@ -82,7 +83,7 @@
   "bugs": {
     "url": "https://github.com/shakacode/react_on_rails/issues"
   },
-  "homepage": "https://github.com/shakacode/react_on_rails#readme",
+  "homepage": "https://reactonrails.com/docs/pro/",
   "devDependencies": {
     "@types/mock-fs": "^4.13.4",
     "mock-fs": "^5.5.0",

packages/react-on-rails/README.md

@@ -14,6 +14,14 @@ pnpm add react-on-rails
 
 **Using React on Rails Pro?** Install [`react-on-rails-pro`](https://www.npmjs.com/package/react-on-rails-pro) instead. The Pro package re-exports everything from this package plus Pro-exclusive features. The `react_on_rails_pro` gem requires the Pro npm package.
 
+## Need More Than OSS?
+
+If you want React Server Components, streaming SSR, fragment caching, or faster Node-based SSR, try [`react-on-rails-pro`](https://www.npmjs.com/package/react-on-rails-pro). It is free to evaluate in development, CI/CD, and staging; production licenses are required only for production deployments.
+
+- [Compare OSS vs Pro](https://reactonrails.com/docs/getting-started/oss-vs-pro/)
+- [Pro quick start](https://reactonrails.com/docs/getting-started/pro-quick-start/)
+- [React on Rails Pro overview](https://reactonrails.com/docs/pro/)
+
 ## Quick Start
 
 ### Register Components

packages/react-on-rails/package.json

@@ -15,7 +15,8 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/shakacode/react_on_rails.git"
+    "url": "git+https://github.com/shakacode/react_on_rails.git",
+    "directory": "packages/react-on-rails"
   },
   "keywords": [
     "react",
@@ -69,5 +70,5 @@
   "bugs": {
     "url": "https://github.com/shakacode/react_on_rails/issues"
   },
-  "homepage": "https://github.com/shakacode/react_on_rails#readme"
+  "homepage": "https://reactonrails.com/docs/"
 }

react_on_rails/react_on_rails.gemspec

@@ -13,8 +13,16 @@ Gem::Specification.new do |s|
 
   s.summary       = "Rails with react server rendering with webpack. "
   s.description   = "See README.md"
-  s.homepage      = "https://github.com/shakacode/react_on_rails"
+  s.homepage      = "https://reactonrails.com/docs/"
   s.license       = "MIT"
+  s.metadata = {
+    "bug_tracker_uri" => "https://github.com/shakacode/react_on_rails/issues",
+    "changelog_uri" => "https://github.com/shakacode/react_on_rails/blob/main/CHANGELOG.md",
+    "documentation_uri" => "https://reactonrails.com/docs/",
+    "homepage_uri" => "https://reactonrails.com/docs/",
+    "rubygems_mfa_required" => "true",
+    "source_code_uri" => "https://github.com/shakacode/react_on_rails/tree/main/react_on_rails"
+  }
 
   s.files = Dir.chdir(__dir__) do
     `git ls-files -z`.split("\x0").reject do |f|
@@ -37,12 +45,14 @@ Gem::Specification.new do |s|
   s.add_dependency "shakapacker", ">= 6.0"
 
   s.add_development_dependency "gem-release"
-  s.post_install_message = '
---------------------------------------------------------------------------------
-Checkout https://pro.reactonrails.com for information about
-"React on Rails Pro" which includes a gem for better performance, via caching helpers, and our
-node rendering server, support for React 19, and much more.
---------------------------------------------------------------------------------
-'
+  s.post_install_message = <<~MESSAGE
+    --------------------------------------------------------------------------------
+    Need React Server Components, streaming SSR, caching, or faster Node-based SSR?
+    React on Rails Pro is free to try in development, CI/CD, and staging.
+    Compare OSS vs Pro: https://reactonrails.com/docs/getting-started/oss-vs-pro/
+    Pro quick start: https://reactonrails.com/docs/getting-started/pro-quick-start/
+    Contact ShakaCode: https://www.shakacode.com/contact/
+    --------------------------------------------------------------------------------
+  MESSAGE
 end
 # rubocop:enable Metrics/BlockLength

react_on_rails_pro/react_on_rails_pro.gemspec

@@ -16,9 +16,14 @@ Gem::Specification.new do |s|
 
   s.summary       = "Rails with react server rendering with webpack. Performance helpers"
   s.description   = "See README.md"
-  s.homepage      = "https://github.com/shakacode/react_on_rails_pro"
+  s.homepage      = "https://reactonrails.com/docs/pro/"
   s.license       = "UNLICENSED"
   s.metadata["rubygems_mfa_required"] = "true"
+  s.metadata["bug_tracker_uri"] = "https://github.com/shakacode/react_on_rails/issues"
+  s.metadata["changelog_uri"] = "https://github.com/shakacode/react_on_rails/blob/main/CHANGELOG.md"
+  s.metadata["documentation_uri"] = "https://reactonrails.com/docs/pro/"
+  s.metadata["homepage_uri"] = "https://reactonrails.com/docs/pro/"
+  s.metadata["source_code_uri"] = "https://github.com/shakacode/react_on_rails/tree/main/react_on_rails_pro"
 
   s.files = Dir.chdir(__dir__) do
     `git ls-files -z`.split("\x0").reject do |f|
@@ -32,14 +37,14 @@ Gem::Specification.new do |s|
   s.required_ruby_version = ">= 3.0"
 
   s.add_runtime_dependency "addressable"
+  s.add_runtime_dependency "async", ">= 2.29"
   s.add_runtime_dependency "connection_pool"
   s.add_runtime_dependency "execjs", "~> 2.9"
-  s.add_runtime_dependency "httpx", ">= 1.7.0"
   # Needed to avoid this bug at httpx versions >= 1.6.0:
   #   https://github.com/HoneyryderChuck/httpx/issues/118
   s.add_runtime_dependency "http-2", ">= 1.1.1"
+  s.add_runtime_dependency "httpx", "~> 1.5"
   s.add_runtime_dependency "jwt", "~> 2.7"
-  s.add_runtime_dependency "async", ">= 2.29"
   s.add_runtime_dependency "rainbow"
   s.add_runtime_dependency "react_on_rails", ReactOnRails::VERSION
   s.add_development_dependency "bundler"