react_on_rails_pro 16.2.1 → 16.3.0.rc.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c44a87b4e8401b0cdb0c0b8740b014635e337fc6a4c39b045cfd308dae75f027
-  data.tar.gz: 73528efb629e2be5b53fba3a26899117b4c31cbe8a001081c47528a059117198
+  metadata.gz: 9bcbae8e9b968c6c6b8b9f707f9c7595015c56af77c29e3b0c069063469bd812
+  data.tar.gz: a084d5851b315254056a147320f70c14a2052fe5c4dee0244171d0281ae75053
 SHA512:
-  metadata.gz: '0483f856ff441114ecf28309e76d6f7478356122e93e77eba41bc7de1a30bc328392e9434b1e67b33c42760e584506cbda6c2996990d674c67e158b5d5080d45'
-  data.tar.gz: 28f79e61ec4caf549487fdda8ac2884704bf4e9fa4eb7deff073ac454044059a3a53bd129f8cb5c9a96bcabc807fb8339fdc6550b9cc51711555593fe32c08e0
+  metadata.gz: 0a5a0c698d58a49260e31acd91ac9cc8d7135229e838dd890df0aa415bec027a39db2afaee1257218fecf0e85c82c468b9d37bd92b5a27abbbd78bc16ce2500f
+  data.tar.gz: 520c471a7c2bbd168664f2d719d1ca3e8dd1e8d028d8bc2b8ebadccd1fe633cf6bdfa3e9bb4adca916d351ecf22f42ddc58db00fe6976353913700ed16ecc393

data/CHANGELOG.md

@@ -6,8 +6,8 @@ All notable changes to this project will be documented in this file. Items under
 
 Gem and package versions are the same except for beta releases where the gem uses a `.beta` and the package uses a `-beta` (same for `rc`).
 
-1. **Gem**: `3.0.0.rc.1`
-2. **Package**: `3.0.0-rc.1`
+1. **Gem**: `X.X.X.beta.X`
+2. **Package**: `X.X.X-beta.X`
 
 You can find the **package** version numbers from this repo's tags and below in this file.
 
@@ -19,9 +19,15 @@ You can find the **package** version numbers from this repo's tags and below in
 
 Changes since the last non-beta release.
 
-### [v16.2.0.rc.0] - 2025-12-29
+### Changed
 
-Changes since the last non-beta release.
+- **License-Optional Attribution Model**: React on Rails Pro now works without a license for evaluation, development, testing, and CI/CD. A paid license is only required for production deployments. Added `plan` field validation to both Ruby and Node.js license validators — only `"paid"` plan (or no plan field for backwards compatibility) is accepted. Old free licenses are now treated as invalid. Documentation overhauled across README and LICENSE_SETUP guides; removed CI_SETUP.md (CI needs no license configuration). [PR 2324](https://github.com/shakacode/react_on_rails/pull/2324) by [AbanoubGhadban](https://github.com/AbanoubGhadban).
+
+### Added
+
+- **Node Renderer Master/Worker Exports**: Added public `master` and `worker` exports to `react-on-rails-pro-node-renderer` package, allowing users to import from `react-on-rails-pro-node-renderer/master` and `react-on-rails-pro-node-renderer/worker`. [PR 2326](https://github.com/shakacode/react_on_rails/pull/2326) by [justin808](https://github.com/justin808).
+
+## [16.2.0] - 2026-01-14
 
 ### Improved
 
@@ -34,7 +40,6 @@ Changes since the last non-beta release.
 - Added `cached_stream_react_component` helper method, similar to `cached_react_component` but for streamed components.
 - **License Validation System**: Implemented comprehensive JWT-based license validation with offline verification using RSA-256 signatures. License validation occurs at startup in both Ruby and Node.js environments. Supports required fields (`sub`, `iat`, `exp`) and optional fields (`plan`, `organization`, `iss`). FREE evaluation licenses are available for 3 months at [shakacode.com/react-on-rails-pro](https://shakacode.com/react-on-rails-pro). [PR #1857](https://github.com/shakacode/react_on_rails/pull/1857) by [AbanoubGhadban](https://github.com/AbanoubGhadban).
 - **Pro-Specific Configurations Moved from Open-Source**: The following React Server Components (RSC) configurations are now exclusively in the Pro gem and should be configured in `ReactOnRailsPro.configure`:
-
   - `rsc_bundle_js_file` - Path to the RSC bundle file
   - `react_server_client_manifest_file` - Path to the React server client manifest
   - `react_client_manifest_file` - Path to the React client manifest
@@ -42,7 +47,6 @@ Changes since the last non-beta release.
   These configurations were previously available in the open-source `ReactOnRails.configure` block but have been moved to Pro where they belong since RSC is a Pro-only feature.
 
 - **Streaming View Helpers Now Pro-Exclusive**: The following view helpers are now defined exclusively in the Pro gem:
-
   - `stream_react_component` - Progressive SSR using React 18+ streaming
   - `rsc_payload_react_component` - RSC payload rendering
 
@@ -66,8 +70,6 @@ Changes since the last non-beta release.
 
 - **Body Duplication Bug On Streaming**: Fixed a bug that happens while streaming if the node renderer connection closed after streaming some chunks to the client. [PR 1995](https://github.com/shakacode/react_on_rails/pull/1995) by [AbanoubGhadban](https://github.com/AbanoubGhadban).
 
-### Changed
-
 ### Deprecated
 
 - **Node Renderer Configuration**: Renamed `bundlePath` configuration option to `serverBundleCachePath` in the node renderer to better describe its purpose and avoid confusion with Shakapacker's public bundle path. The old `bundlePath` option continues to work with deprecation warnings. Both `RENDERER_SERVER_BUNDLE_CACHE_PATH` (new) and `RENDERER_BUNDLE_PATH` (deprecated) environment variables are supported. [PR 2008](https://github.com/shakacode/react_on_rails/pull/2008) by [justin808](https://github.com/justin808).
@@ -121,7 +123,6 @@ Changes since the last non-beta release.
 ### Changed
 
 - [PR 511](https://github.com/shakacode/react_on_rails_pro/pull/511) by [Romex91](https://github.com/Romex91)
-
   - Set `bodyLimit` to 100 MB by default to fix error 413.
   - Add `fastifyServerOptions` to the config
 
@@ -268,7 +269,6 @@ React 18 is now supported! Check the [React on Rails CHANGELOG.md](https://githu
 ### Added
 
 - [PR 220](https://github.com/shakacode/react_on_rails_pro/pull/220) by [justin808](https://github.com/justin808).
-
   - **Add `ssr_timeout` configuration** so the Rails server will not wait more than this many seconds for a SSR request to return once issued.
   - Change default for `renderer_use_fallback_exec_js` to `false`.
   - Change default log level to info.
@@ -547,9 +547,8 @@ Above changes in [PR 52](https://github.com/shakacode/react_on_rails_pro/pull/52
 - support for javascript evaluation caching
 - advanced error handling
 
-[HEAD compared to 3.2.1]: https://github.com/shakacode/react_on_rails_pro/compare/3.3.1...HEAD
-[Unreleased]: https://github.com/shakacode/react_on_rails/compare/v16.2.0.rc.0...master
-[v16.2.0.rc.0]: https://github.com/shakacode/react_on_rails/compare/16.1.1...v16.2.0.rc.0
+[Unreleased]: https://github.com/shakacode/react_on_rails/compare/v16.2.0...master
+[16.2.0]: https://github.com/shakacode/react_on_rails/compare/v16.2.0.beta.0...v16.2.0
 [4.0.0-rc.15]: https://github.com/shakacode/react_on_rails_pro/compare/4.0.0-rc.14...4.0.0-rc.15
 [4.0.0.rc.11]: https://github.com/shakacode/react_on_rails_pro/compare/4.0.0-rc.9...4.0.0-rc.11
 [4.0.0.rc.9]: https://github.com/shakacode/react_on_rails_pro/compare/4.0.0-rc.6...4.0.0-rc.9

data/Gemfile.development_dependencies

@@ -6,11 +6,9 @@ eval_gemfile File.expand_path("../Gemfile.shared_dev_dependencies", __dir__)
 
 git_source(:github) { |repo| "https://github.com/#{repo}.git" }
 
-ruby '3.3.7'
-
 gem "react_on_rails", path: "../"
 
-gem "shakapacker", "9.4.0"
+gem "shakapacker", "9.5.0"
 gem "bootsnap", require: false
 gem "rails", "~> 7.1"
 gem "puma", "~> 6"

data/Gemfile.lock

@@ -9,7 +9,7 @@ GIT
 PATH
   remote: ..
   specs:
-    react_on_rails (16.2.1)
+    react_on_rails (16.3.0.rc.1)
       addressable
       connection_pool
       execjs (~> 2.5)
@@ -20,7 +20,7 @@ PATH
 PATH
   remote: .
   specs:
-    react_on_rails_pro (16.2.1)
+    react_on_rails_pro (16.3.0.rc.1)
       addressable
       async (>= 2.6)
       connection_pool
@@ -29,7 +29,7 @@ PATH
       httpx (~> 1.5)
       jwt (~> 2.7)
       rainbow
-      react_on_rails (= 16.2.1)
+      react_on_rails (= 16.3.0.rc.1)
 
 GEM
   remote: https://rubygems.org/
@@ -119,7 +119,7 @@ GEM
       traces (~> 0.18)
     base64 (0.3.0)
     benchmark (0.5.0)
-    bigdecimal (3.3.1)
+    bigdecimal (4.0.1)
     bindex (0.8.1)
     bootsnap (1.18.3)
       msgpack (~> 1.2)
@@ -137,13 +137,13 @@ GEM
     capybara-screenshot (1.0.26)
       capybara (>= 1.0, < 4)
       launchy
-    cgi (0.5.0)
+    cgi (0.5.1)
     childprocess (5.0.0)
     coderay (1.1.3)
     commonmarker (1.1.4-arm64-darwin)
     commonmarker (1.1.4-x86_64-darwin)
     commonmarker (1.1.4-x86_64-linux)
-    concurrent-ruby (1.3.5)
+    concurrent-ruby (1.3.6)
     connection_pool (3.0.2)
     console (1.34.2)
       fiber-annotation
@@ -159,13 +159,13 @@ GEM
       bigdecimal
       rexml
     crass (1.0.6)
-    date (3.5.0)
+    date (3.5.1)
     diff-lcs (1.5.1)
     docile (1.4.0)
     drb (2.2.3)
     equivalent-xml (0.6.0)
       nokogiri (>= 1.4.3)
-    erb (6.0.0)
+    erb (6.0.1)
     erubi (1.13.1)
     execjs (2.10.0)
     fakefs (2.8.0)
@@ -190,11 +190,11 @@ GEM
     http-2 (1.1.1)
     httpx (1.6.3)
       http-2 (>= 1.0.0)
-    i18n (1.14.7)
+    i18n (1.14.8)
       concurrent-ruby (~> 1.0)
-    io-console (0.8.1)
+    io-console (0.8.2)
     io-event (1.14.2)
-    irb (1.15.3)
+    irb (1.16.0)
       pp (>= 0.6.0)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
@@ -216,7 +216,7 @@ GEM
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
     logger (1.7.0)
-    loofah (2.24.1)
+    loofah (2.25.0)
       crass (~> 1.0.2)
       nokogiri (>= 1.12.0)
     mail (2.9.0)
@@ -230,7 +230,8 @@ GEM
     method_source (1.1.0)
     metrics (0.15.0)
     mini_mime (1.1.5)
-    minitest (5.26.2)
+    minitest (6.0.1)
+      prism (~> 1.5)
     mize (0.4.1)
       protocol (~> 2.0)
     msgpack (1.7.2)
@@ -246,11 +247,11 @@ GEM
     net-smtp (0.5.1)
       net-protocol
     nio4r (2.7.5)
-    nokogiri (1.18.10-arm64-darwin)
+    nokogiri (1.19.0-arm64-darwin)
       racc (~> 1.4)
-    nokogiri (1.18.10-x86_64-darwin)
+    nokogiri (1.19.0-x86_64-darwin)
       racc (~> 1.4)
-    nokogiri (1.18.10-x86_64-linux-gnu)
+    nokogiri (1.19.0-x86_64-linux-gnu)
       racc (~> 1.4)
     package_json (0.2.0)
     parallel (1.27.0)
@@ -274,7 +275,7 @@ GEM
       pry (>= 0.13.0)
     pry-theme (1.3.1)
       coderay (~> 1.1)
-    psych (5.2.6)
+    psych (5.3.1)
       date
       stringio
     public_suffix (7.0.0)
@@ -329,7 +330,7 @@ GEM
       ffi (~> 1.0)
     rbs (3.9.5)
       logger
-    rdoc (6.16.1)
+    rdoc (7.1.0)
       erb
       psych (>= 4.0.0)
       tsort
@@ -415,7 +416,7 @@ GEM
       websocket (~> 1.0)
     semantic_range (3.1.0)
     sexp_processor (4.17.1)
-    shakapacker (9.4.0)
+    shakapacker (9.5.0)
       activesupport (>= 5.2)
       package_json
       rack-proxy (>= 0.6.1)
@@ -440,12 +441,12 @@ GEM
     sqlite3 (1.7.3-arm64-darwin)
     sqlite3 (1.7.3-x86_64-darwin)
     sqlite3 (1.7.3-x86_64-linux)
-    stringio (3.1.9)
+    stringio (3.2.0)
     sync (0.5.0)
     term-ansicolor (1.10.2)
       mize
       tins (~> 1.0)
-    thor (1.4.0)
+    thor (1.5.0)
     tilt (2.4.0)
     timeout (0.4.4)
     tins (1.33.0)
@@ -482,7 +483,7 @@ GEM
     xpath (3.2.0)
       nokogiri (~> 1.8)
     yard (0.9.36)
-    zeitwerk (2.7.3)
+    zeitwerk (2.7.4)
 
 PLATFORMS
   arm64-darwin-24
@@ -530,7 +531,7 @@ DEPENDENCIES
   sass-rails
   scss_lint
   selenium-webdriver (= 4.9.0)
-  shakapacker (= 9.4.0)
+  shakapacker (= 9.5.0)
   spring
   spring-watcher-listen
   sprockets
@@ -541,8 +542,5 @@ DEPENDENCIES
   webmock
   yard
 
-RUBY VERSION
-   ruby 3.3.7p123
-
 BUNDLED WITH
    2.5.4

data/LICENSE_SETUP.md

@@ -1,35 +1,53 @@
 # React on Rails Pro License Setup
 
-This document explains how to configure your React on Rails Pro license.
+This document explains how to configure your React on Rails Pro license for production use.
 
-## Getting a FREE License
+## License-Optional Model
 
-**All users need a license** - even for development and evaluation!
+React on Rails Pro works **without a license** for evaluation, development, testing, and CI/CD. No registration or license key is needed to get started.
 
-### Get Your FREE Evaluation License (3 Months)
+**A paid license is required only for production deployments.**
 
-1. Visit [https://shakacode.com/react-on-rails-pro](https://shakacode.com/react-on-rails-pro)
-2. Register with your email
-3. Receive your FREE 3-month evaluation license immediately
-4. Use it for development, testing, and evaluation
+| Environment        | License Required? |
+| ------------------ | ----------------- |
+| Development        | No                |
+| Test               | No                |
+| CI/CD              | No                |
+| Staging (non-prod) | No                |
+| Production         | **Yes** (paid)    |
 
-**No credit card required!**
+## Upgrading from Previous Versions
 
-**⚠️ Important: The free 3-month evaluation license is intended for personal, educational, and evaluation purposes only. It should NOT be used for production deployments. Production use requires a paid license.**
+If you're upgrading from an earlier version of React on Rails Pro, note these changes:
 
-## License Types
+### Breaking Changes
 
-### Free License
-- **Duration**: 3 months
-- **Usage**: Personal, educational, and evaluation purposes only (development, testing, evaluation, CI/CD) - **NOT for production**
-- **Cost**: FREE - just register with your email
-- **Renewal**: Get a new free license or upgrade to paid
+- **`ReactOnRailsPro::Utils.licensed?` has been removed** — Use `ReactOnRailsPro::LicenseValidator.license_status == :valid` instead
+- **`ReactOnRailsPro::LicenseValidator.license_data` has been removed** — Only `license_status` and `license_expiration` are available
+- **The app will no longer crash on invalid/missing licenses** — License issues are now logged as warnings in production and info in non-production environments
 
-### Paid License
-- **Duration**: 1 year (or longer)
-- **Usage**: Production deployment
-- **Cost**: Subscription-based
-- **Support**: Includes professional support
+### Migration Steps
+
+1. **Remove any custom error handling for license exceptions** — The license validator no longer raises exceptions
+2. **Update license status checks:**
+
+   ```ruby
+   # Old (removed)
+   ReactOnRailsPro::Utils.licensed?
+
+   # New
+   ReactOnRailsPro::LicenseValidator.license_status == :valid
+   ```
+
+3. **Remove any code that accessed `license_data`** — This method is no longer available
+
+### Behavior Changes
+
+- **Missing license**: Previously raised an error in production. Now logs a warning and continues running.
+- **Expired license**: Previously raised an error. Now logs a warning and continues running.
+- **Invalid license**: Previously raised an error. Now logs a warning and continues running.
+
+This change allows your application to start even with license issues, giving you time to resolve them without downtime.
 
 ## Installation
 
@@ -44,17 +62,14 @@ export REACT_ON_RAILS_PRO_LICENSE="eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9..."
 **For different environments:**
 
 ```bash
-# Development (.env file)
-REACT_ON_RAILS_PRO_LICENSE=your_license_token_here
-
 # Production (Heroku)
 heroku config:set REACT_ON_RAILS_PRO_LICENSE="your_token"
 
 # Production (Docker)
 # Add to docker-compose.yml or Dockerfile ENV
 
-# CI/CD
-# Add to your CI environment variables (see CI_SETUP.md)
+# CI/CD (optional — CI works without a license)
+# Add to your CI environment variables if needed
 ```
 
 ### Method 2: Configuration File
@@ -82,126 +97,76 @@ The license is validated at multiple points:
 2. **Node Renderer**: When the Node renderer process starts
 3. **Browser Package**: Trusts server-side validation (via `railsContext.rorPro`)
 
-### All Environments Require Valid License
-
-React on Rails Pro requires a valid license in **all environments**:
-
-- ✅ **Development**: Requires license (use FREE license) - **Fails immediately on expiration**
-- ✅ **Test**: Requires license (use FREE license) - **Fails immediately on expiration**
-- ✅ **CI/CD**: Requires license (use FREE license) - **Fails immediately on expiration**
-- ✅ **Production**: Requires license (use paid license) - **1-month grace period after expiration**
-
-Get your FREE evaluation license in 30 seconds - no credit card required!
-
-### Production Grace Period
-
-**Production environments only** receive a **1-month grace period** when a license expires:
-
-- ⚠️ **During grace period**: Application continues to run but logs ERROR messages on every startup
-- ❌ **After grace period**: Application fails to start (same as dev/test)
-- 🔔 **Warning messages**: Include days remaining in grace period
-- ✅ **Development/Test**: No grace period - fails immediately (helps catch expiration early)
-
-**Important**: The grace period is designed to give production deployments time to renew, but you should:
-1. Monitor your logs for license expiration warnings
-2. Renew licenses before they expire
-3. Test license renewal in development/staging first
+When no license is present, the application runs in **unlicensed mode**. This is fine for development, testing, and CI/CD. Production deployments should always have a valid paid license.
 
 ## Team Setup
 
 ### For Development Teams
 
-Each developer should:
+No license setup is needed for development. Developers can install and use React on Rails Pro immediately.
 
-1. Get their own FREE license from [shakacode.com](https://shakacode.com/react-on-rails-pro)
-2. Store it locally using one of the methods above
-3. Ensure `config/react_on_rails_pro_license.key` is in your `.gitignore`
+For production deployments, share a paid license via environment variable or configuration file.
 
 ### For CI/CD
 
-Set up CI with a license (see [CI_SETUP.md](./CI_SETUP.md) for detailed instructions):
-
-1. Get a FREE license (can use any team member's or create `ci@yourcompany.com`)
-2. Add to CI environment variables as `REACT_ON_RAILS_PRO_LICENSE`
-3. Renew every 3 months (or use a paid license)
-
-**Recommended**: Use GitHub Secrets, GitLab CI Variables, or your CI provider's secrets management.
+CI/CD environments work without a license. If your CI pipeline deploys to production, ensure the production environment has a valid paid license configured.
 
 ## Verification
 
 ### Verify License is Working
 
 **Ruby Console:**
+
 ```ruby
 rails console
 > ReactOnRails::Utils.react_on_rails_pro?
 # Should return: true
 ```
 
-**Note:** With startup validation enabled, your Rails app won't start with an invalid license. If you can run the Rails console, your license is valid.
-
-**Check License Details:**
-```ruby
-> ReactOnRailsPro::LicenseValidator.license_data
-# Shows: {"sub"=>"your@email.com", "exp"=>1234567890, "plan"=>"free", ...}
-```
-
 **Browser JavaScript Console:**
+
 ```javascript
-window.railsContext.rorPro
+window.railsContext.rorPro;
 // Should return: true
 ```
 
 ## Troubleshooting
 
-### Error: "No license found"
+### Warning: "No license found"
 
-**Solutions:**
-1. Verify environment variable: `echo $REACT_ON_RAILS_PRO_LICENSE`
-2. Check config file exists: `ls config/react_on_rails_pro_license.key`
-3. **Get a FREE license**: [https://shakacode.com/react-on-rails-pro](https://shakacode.com/react-on-rails-pro)
+This is expected behavior in development, test, and CI environments. The application will run in unlicensed mode. For production, ensure the `REACT_ON_RAILS_PRO_LICENSE` environment variable is set.
 
 ### Error: "Invalid license signature"
 
 **Causes:**
+
 - License token was truncated or modified
 - Wrong license format (must be complete JWT token)
 
 **Solutions:**
+
 1. Ensure you copied the complete license (starts with `eyJ`)
 2. Check for extra spaces or newlines
-3. Get a new FREE license if corrupted
+3. Contact [support@shakacode.com](mailto:support@shakacode.com) for a replacement
 
 ### Error: "License has expired"
 
-**What happens:**
-- **Development/Test/CI**: Application fails to start immediately
-- **Production**: 1-month grace period with ERROR logs, then fails to start
-
 **Solutions:**
-1. **Free License**: Get a new 3-month FREE license
-2. **Paid License**: Contact support to renew
-3. Visit: [https://shakacode.com/react-on-rails-pro](https://shakacode.com/react-on-rails-pro)
 
-**If you see grace period warnings in production:**
-- You have time to renew, but don't wait!
-- The warning shows how many days remain
-- Plan your license renewal before the grace period ends
+1. Contact [support@shakacode.com](mailto:support@shakacode.com) to renew your paid license
+2. Update the `REACT_ON_RAILS_PRO_LICENSE` environment variable with the new token
 
-### Error: "License is missing required expiration field"
+### Error: "License plan is not valid for production use"
 
-**Cause:** You may have an old license format
+**Cause:** The license has a plan that is not authorized for production use (e.g., an old free evaluation license).
 
-**Solution:** Get a new FREE license from [shakacode.com](https://shakacode.com/react-on-rails-pro)
+**Solution:** Purchase a paid license. Contact [justin@shakacode.com](mailto:justin@shakacode.com) for pricing.
 
-### Application Won't Start
+### Error: "License is missing required expiration field"
 
-If your application fails to start due to license issues:
+**Cause:** You may have an old or malformed license token.
 
-1. **Quick fix**: Set a valid license environment variable
-2. **Get FREE license**: Takes 30 seconds at [shakacode.com](https://shakacode.com/react-on-rails-pro)
-3. Check logs for specific error message
-4. Ensure license is accessible to all processes (Rails + Node renderer)
+**Solution:** Contact [support@shakacode.com](mailto:support@shakacode.com) for a new license.
 
 ## License Technical Details
 
@@ -211,12 +176,12 @@ The license is a JWT (JSON Web Token) signed with RSA-256, containing:
 
 ```json
 {
-  "sub": "user@example.com",        // Your email (REQUIRED)
-  "iat": 1234567890,                 // Issued at timestamp (REQUIRED)
-  "exp": 1234567890,                 // Expiration timestamp (REQUIRED)
-  "plan": "free",                    // License plan: "free" or "paid" (Optional)
-  "organization": "Your Company",    // Organization name (Optional)
-  "iss": "api"                       // Issuer identifier (Optional, standard JWT claim)
+  "sub": "user@example.com", // Your email (REQUIRED)
+  "iat": 1234567890, // Issued at timestamp (REQUIRED)
+  "exp": 1234567890, // Expiration timestamp (REQUIRED)
+  "plan": "paid", // License plan (Optional — only "paid" is valid for production)
+  "organization": "Your Company", // Organization name (Optional)
+  "iss": "api" // Issuer identifier (Optional, standard JWT claim)
 }
 ```
 
@@ -229,7 +194,6 @@ The license is a JWT (JSON Web Token) signed with RSA-256, containing:
 
 ### Privacy
 
-- We only collect email during registration
 - No usage tracking or phone-home in the license system
 - License is validated offline using cryptographic signatures
 
@@ -237,36 +201,23 @@ The license is a JWT (JSON Web Token) signed with RSA-256, containing:
 
 Need help?
 
-1. **Quick Start**: Get a FREE license at [shakacode.com/react-on-rails-pro](https://shakacode.com/react-on-rails-pro)
-2. **Documentation**: Check [CI_SETUP.md](./CI_SETUP.md) for CI configuration
-3. **Email**: support@shakacode.com
-4. **License Management**: [shakacode.com/react-on-rails-pro](https://shakacode.com/react-on-rails-pro)
+1. **Email**: support@shakacode.com
+2. **Sales**: [justin@shakacode.com](mailto:justin@shakacode.com) for pricing
 
 ## Security Best Practices
 
-1. ✅ **Never commit licenses to Git** - Add `config/react_on_rails_pro_license.key` to `.gitignore`
+1. ✅ **Never commit licenses to Git** — Add `config/react_on_rails_pro_license.key` to `.gitignore`
 2. ✅ **Use environment variables in production**
-3. ✅ **Use CI secrets for CI/CD environments**
+3. ✅ **Use CI secrets for production deployment pipelines**
 4. ✅ **Don't share licenses publicly**
-5. ✅ **Each developer gets their own FREE license**
-6. ✅ **Renew before expiration** (we'll send reminders)
 
 ## FAQ
 
-**Q: Why do I need a license for development?**
-A: We provide FREE 3-month licenses so we can track usage and provide better support. Registration takes 30 seconds!
-
-**Q: Can I use a free license in production?**
-A: Free licenses are for evaluation only. Production deployments require a paid license.
+**Q: Do I need a license for development?**
+A: No. React on Rails Pro works without a license for development, testing, and evaluation.
 
-**Q: Can multiple developers share one license?**
-A: Each developer should get their own FREE license. For CI, you can share one license via environment variable.
-
-**Q: What happens when my free license expires?**
-A: Get a new 3-month FREE license, or upgrade to a paid license for production use.
+**Q: Do I need a license for CI?**
+A: No. CI/CD environments work without a license. Only production deployments require a paid license.
 
 **Q: Do I need internet to validate the license?**
 A: No! License validation is completely offline using cryptographic signatures.
-
-**Q: Is my email shared or sold?**
-A: Never. We only use it to send you license renewals and important updates.