react_on_rails_pro 16.4.0.rc.1 → 16.4.0.rc.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/Gemfile.lock +3 -3
- data/docs/installation.md +62 -0
- data/docs/node-renderer/basics.md +2 -0
- data/lib/react_on_rails_pro/version.rb +1 -1
- metadata +4 -4
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: ba2d4fba2da62ea800b08b93c39a2f6fc1af6dc0cdf369b4e7045ea63295411e
|
|
4
|
+
data.tar.gz: 95089a0c6cbc5e33f77e270c3a08dd52701a98c123f546c13bc78d9f14ed686e
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 4ee11ab1fffd34d46b706907581097c6988177b93d5a3d251fd30661f91d97194681641316ba76b16bd5c49ab8000c25f524cb02053c7ae8934232d9a0440aa0
|
|
7
|
+
data.tar.gz: 577fe3c1a25606be9a4e7269d808d949005068150652a5148b8af5262c58d9c8064c9687c0989dadaa46841ba1da6b2832fb8081f776a0d6f1d3d27b75b718a8
|
data/Gemfile.lock
CHANGED
|
@@ -9,7 +9,7 @@ GIT
|
|
|
9
9
|
PATH
|
|
10
10
|
remote: ..
|
|
11
11
|
specs:
|
|
12
|
-
react_on_rails (16.4.0.rc.
|
|
12
|
+
react_on_rails (16.4.0.rc.2)
|
|
13
13
|
addressable
|
|
14
14
|
connection_pool
|
|
15
15
|
execjs (~> 2.5)
|
|
@@ -20,7 +20,7 @@ PATH
|
|
|
20
20
|
PATH
|
|
21
21
|
remote: .
|
|
22
22
|
specs:
|
|
23
|
-
react_on_rails_pro (16.4.0.rc.
|
|
23
|
+
react_on_rails_pro (16.4.0.rc.2)
|
|
24
24
|
addressable
|
|
25
25
|
async (>= 2.6)
|
|
26
26
|
connection_pool
|
|
@@ -29,7 +29,7 @@ PATH
|
|
|
29
29
|
httpx (~> 1.5)
|
|
30
30
|
jwt (~> 2.7)
|
|
31
31
|
rainbow
|
|
32
|
-
react_on_rails (= 16.4.0.rc.
|
|
32
|
+
react_on_rails (= 16.4.0.rc.2)
|
|
33
33
|
|
|
34
34
|
GEM
|
|
35
35
|
remote: https://rubygems.org/
|
data/docs/installation.md
CHANGED
|
@@ -13,6 +13,68 @@ For the below docs, find the desired `<version>` in the CHANGELOG. Note that for
|
|
|
13
13
|
- Gems use all periods: `16.2.0.beta.1`
|
|
14
14
|
- NPM packages use dashes: `16.2.0-beta.1`
|
|
15
15
|
|
|
16
|
+
# Generator Installation (Recommended)
|
|
17
|
+
|
|
18
|
+
The easiest way to set up React on Rails Pro is using the generator. This automates most of the manual steps described below.
|
|
19
|
+
|
|
20
|
+
## Fresh Installation
|
|
21
|
+
|
|
22
|
+
For new React on Rails apps, use the `--pro` flag:
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
# Add the Pro gem to your Gemfile first
|
|
26
|
+
bundle add react_on_rails_pro
|
|
27
|
+
|
|
28
|
+
# Run the generator with --pro
|
|
29
|
+
rails generate react_on_rails:install --pro
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
This creates the Pro initializer, node-renderer.js, installs npm packages, and adds the Node Renderer to Procfile.dev.
|
|
33
|
+
|
|
34
|
+
## Upgrading an Existing App
|
|
35
|
+
|
|
36
|
+
For existing React on Rails apps, use the standalone Pro generator:
|
|
37
|
+
|
|
38
|
+
```bash
|
|
39
|
+
# Add the Pro gem to your Gemfile
|
|
40
|
+
bundle add react_on_rails_pro
|
|
41
|
+
|
|
42
|
+
# Run the Pro generator
|
|
43
|
+
rails generate react_on_rails:pro
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
The standalone generator adds Pro-specific files and modifies your existing webpack configs (`serverWebpackConfig.js` and `ServerClientOrBoth.js`) to enable Pro features like `libraryTarget: 'commonjs2'` and `target = 'node'`.
|
|
47
|
+
|
|
48
|
+
## After Running the Generator
|
|
49
|
+
|
|
50
|
+
You still need to configure your license. Set the environment variable:
|
|
51
|
+
|
|
52
|
+
```bash
|
|
53
|
+
export REACT_ON_RAILS_PRO_LICENSE="your-license-token-here"
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
See [License Configuration](#license-configuration-production-only) below for other options.
|
|
57
|
+
|
|
58
|
+
## Adding React Server Components
|
|
59
|
+
|
|
60
|
+
RSC requires React on Rails Pro and React 19.0.x. To add RSC support, use `--rsc` (fresh install) or the RSC generator (existing app):
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
# Fresh install with RSC
|
|
64
|
+
rails generate react_on_rails:install --rsc
|
|
65
|
+
|
|
66
|
+
# Or add RSC to existing Pro app
|
|
67
|
+
rails generate react_on_rails:rsc
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
The RSC generator creates `rscWebpackConfig.js`, adds `RSCWebpackPlugin` to both server and client webpack configs, configures `RSC_BUNDLE_ONLY` handling in `ServerClientOrBoth.js`, and sets up the RSC bundle watcher process. See [React Server Components](./react-server-components/tutorial.md) for more information.
|
|
71
|
+
|
|
72
|
+
---
|
|
73
|
+
|
|
74
|
+
# Manual Installation
|
|
75
|
+
|
|
76
|
+
The sections below describe manual installation steps. Use these if you need fine-grained control or want to understand what the generator creates.
|
|
77
|
+
|
|
16
78
|
# Ruby Gem Installation
|
|
17
79
|
|
|
18
80
|
## Prerequisites
|
|
@@ -10,6 +10,8 @@ See [Installation](../installation.md).
|
|
|
10
10
|
|
|
11
11
|
**node-renderer** is a standalone Node application to serve React SSR requests from a **Rails** client. You don't need any **Ruby** code to setup and launch it. You can configure with the command line or with a launch file.
|
|
12
12
|
|
|
13
|
+
> **Generator shortcut:** Running `rails generate react_on_rails:install --pro` (or `rails generate react_on_rails:pro` for existing apps) automatically creates `client/node-renderer.js`, adds the Node Renderer process to `Procfile.dev`, and installs the required npm packages. See [Installation](../installation.md) for details. The manual setup below is for apps that need custom configuration.
|
|
14
|
+
|
|
13
15
|
## Simple Command Line for node-renderer
|
|
14
16
|
|
|
15
17
|
1. ENV values for the default config are (See [JS Configuration](./js-configuration.md) for more details):
|
metadata
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: react_on_rails_pro
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 16.4.0.rc.
|
|
4
|
+
version: 16.4.0.rc.2
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Justin Gordon
|
|
8
8
|
autorequire:
|
|
9
9
|
bindir: exe
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date: 2026-02-
|
|
11
|
+
date: 2026-02-16 00:00:00.000000000 Z
|
|
12
12
|
dependencies:
|
|
13
13
|
- !ruby/object:Gem::Dependency
|
|
14
14
|
name: addressable
|
|
@@ -128,14 +128,14 @@ dependencies:
|
|
|
128
128
|
requirements:
|
|
129
129
|
- - '='
|
|
130
130
|
- !ruby/object:Gem::Version
|
|
131
|
-
version: 16.4.0.rc.
|
|
131
|
+
version: 16.4.0.rc.2
|
|
132
132
|
type: :runtime
|
|
133
133
|
prerelease: false
|
|
134
134
|
version_requirements: !ruby/object:Gem::Requirement
|
|
135
135
|
requirements:
|
|
136
136
|
- - '='
|
|
137
137
|
- !ruby/object:Gem::Version
|
|
138
|
-
version: 16.4.0.rc.
|
|
138
|
+
version: 16.4.0.rc.2
|
|
139
139
|
- !ruby/object:Gem::Dependency
|
|
140
140
|
name: bundler
|
|
141
141
|
requirement: !ruby/object:Gem::Requirement
|