Update both demos to shakapacker 9.3.0 (#62)

* Update basic-v16-webpack demo to use shakapacker 9.0.0.beta.5

- Update Gemfile to use shakapacker ~> 9.0.0.beta.5 instead of GitHub ref
- Update package.json to use shakapacker 9.0.0-beta.5
- Update Gemfile.lock and package-lock.json
- Fix .new-demo-versions to use proper version instead of GitHub ref
- Apply rubocop auto-fixes for string literal style

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

* Update both demos to shakapacker 9.3.0

- Update basic-v16-webpack from 9.0.0.beta.5 to 9.3.0
- Update basic-v16-rspack from 9.0.0 to 9.3.0
- Regenerate Gemfile.lock and package-lock.json files
- Add CLAUDE.md with upgrade guidelines to prevent config file overwrites

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

* Revert quote style changes in Ruby files

- Revert all single quote to double quote changes
- Keep only the essential shakapacker version updates
- All Ruby files now use double quotes as per Rails Omakase standard

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

* Revert quote changes in binstubs and config files

- Revert single quote to double quote changes in all bin/* files
- Revert Rakefile and config.ru quote changes
- All files now use double quotes per Rails Omakase standard

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

* Update .new-demo-versions to shakapacker 9.3.0

- Change from 9.0.0.beta.5 to 9.3.0 to match the stable release
- Ensures new demos will use the stable version

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

* Fix inconsistent quote style in Gemfile

- Change shakapacker gem line to use single quotes
- Matches the rest of the Gemfile which uses single quotes
- Consistent with Rails Omakase style guide

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

* Use caret (^) version constraint for shakapacker in package.json

- Change from exact pin "9.3.0" to caret range "^9.3.0"
- Matches the ~> constraint in Gemfile (allows patch updates)
- Consistent with other npm dependencies (react, react-on-rails, etc.)
- Allows automatic patch updates (9.3.x) while preventing breaking changes

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

---------

Co-authored-by: Claude <[email protected]>

Author: justin808

.new-demo-versions

@@ -15,7 +15,7 @@ RAILS_VERSION="8.0.3"
 #   SHAKAPACKER_VERSION="github:shakacode/shakapacker"    # GitHub main branch (default)
 #   SHAKAPACKER_VERSION="github:shakacode/shakapacker#fix-hmr"  # GitHub branch (use #)
 #   SHAKAPACKER_VERSION="github:shakacode/[email protected]"   # GitHub tag (use @)
-SHAKAPACKER_VERSION="github:shakacode/shakapacker"
+SHAKAPACKER_VERSION="~> 9.3.0"
 
 # React on Rails version (use ~> for compatibility range, or specific version)
 # Examples:

CLAUDE.md

@@ -0,0 +1,108 @@
+# React on Rails Demo Common - Claude Instructions
+
+## Critical Upgrade Guidelines
+
+### Shakapacker and React on Rails Upgrades
+
+**NEVER revert or overwrite custom configuration files during upgrades.**
+
+When upgrading Shakapacker or React on Rails:
+
+1. **ONLY update version numbers** in:
+   - `Gemfile` - gem version constraints
+   - `package.json` - npm package versions
+   - Lock files (via `bundle install` and `npm install`)
+
+2. **ONLY update binstubs** if:
+   - The upgrade documentation specifically mentions binstub changes
+   - You verify the changes are minimal (path fixes, API updates)
+   - You preserve any custom logic in existing binstubs
+
+3. **NEVER run install commands** that regenerate config files:
+   - ❌ `rails shakapacker:install` - This overwrites custom configurations
+   - ❌ `rails react_on_rails:install` - This reverts to defaults
+   - ✅ `bundle install` - Safe, only updates lock files
+   - ✅ `npm install` - Safe, only updates lock files
+
+4. **Configuration files are sacred**:
+   - `config/shakapacker.yml` - Contains project-specific settings, NEVER overwrite
+   - `config/webpack/webpack.config.js` - Contains custom logic, NEVER replace with defaults
+   - Any `config/webpack/*.js` files - Custom configurations, preserve them
+   - `config/initializers/react_on_rails.rb` - Custom settings, preserve them
+
+5. **Breaking changes workflow**:
+   - Read the CHANGELOG for the version you're upgrading to
+   - Identify breaking changes that require code updates
+   - Make ONLY the specific changes mentioned in the changelog
+   - Test each change individually
+   - NEVER use install generators to "fix" breaking changes
+
+6. **When using swap-deps**:
+   - Local dependency changes (using `bin/swap-deps`) are for development ONLY
+   - NEVER commit or push local gem paths to remote
+   - The pre-push hook will prevent this, but be aware
+   - Use `bin/swap-deps --restore` before committing
+
+### Example: Correct Upgrade Process
+
+```bash
+# 1. Update version in Gemfile
+# Edit: gem 'shakapacker', '~> 9.0.0.beta.10'
+
+# 2. Update version in package.json
+# Edit: "shakapacker": "9.0.0-beta.10"
+
+# 3. Install new versions
+bundle install
+npm install
+
+# 4. Read changelog for breaking changes
+# URL: https://github.com/shakacode/shakapacker/blob/main/CHANGELOG.md
+
+# 5. Apply ONLY specific breaking changes mentioned
+# Example: If API changed from `Shakapacker.config` to `Shakapacker.configuration`
+# grep and replace that specific change
+
+# 6. Test the application
+# bin/dev or bin/rails server
+```
+
+### Example: What NOT to Do
+
+```bash
+# ❌ WRONG - This will overwrite all your custom configurations
+rails shakapacker:install
+
+# ❌ WRONG - This destroys custom webpack logic
+rm config/webpack/webpack.config.js
+rails shakapacker:install
+
+# ❌ WRONG - Running install generators after initial setup
+rails react_on_rails:install
+```
+
+## Demo App Structure
+
+This repository contains demo applications that showcase React on Rails integration:
+- `demos/basic-v16-webpack/` - Webpack-based demo
+- `demos/basic-v16-rspack/` - Rspack-based demo (faster build tool)
+
+Each demo has custom webpack configurations that implement environment-specific loading.
+These configurations are intentional and should be preserved during upgrades.
+
+## Working with Local Dependencies
+
+Use the `bin/swap-deps` tool for local development:
+
+```bash
+# Swap to local shakapacker for development
+bin/swap-deps --shakapacker /path/to/local/shakapacker
+
+# Check what's swapped
+bin/swap-deps --status
+
+# Restore before committing
+bin/swap-deps --restore
+```
+
+**Remember**: Local dependencies should NEVER be committed or pushed.

demos/basic-v16-rspack/Gemfile

@@ -41,7 +41,7 @@ group :development do
   gem "web-console"
 end
 
-gem "shakapacker", "~> 9.0.0"
+gem "shakapacker", "~> 9.3.0"
 
 gem "react_on_rails", "~> 16.1"
 

demos/basic-v16-rspack/Gemfile.lock

@@ -275,7 +275,7 @@ GEM
     ruby-progressbar (1.13.0)
     securerandom (0.4.1)
     semantic_range (3.1.0)
-    shakapacker (9.0.0)
+    shakapacker (9.3.0)
       activesupport (>= 5.2)
       package_json
       rack-proxy (>= 0.6.1)
@@ -332,7 +332,7 @@ DEPENDENCIES
   react_on_rails (~> 16.1)
   rubocop-rails-omakase
   shakacode_demo_common!
-  shakapacker (~> 9.0.0)
+  shakapacker (~> 9.3.0)
   thruster
   tzinfo-data
   web-console

demos/basic-v16-rspack/package-lock.json

@@ -18,7 +18,7 @@
     "react-on-rails": "^16.1.1",
     "rspack-manifest-plugin": "^5.0.0",
     "sass-loader": "^16.0.5",
-    "shakapacker": "^9.0.0",
+    "shakapacker": "^9.3.0",
     "style-loader": "^4.0.0",
     "swc-loader": "^0.2.6"
   },

demos/basic-v16-rspack/package.json

@@ -1,49 +1,49 @@
 # frozen_string_literal: true
 
-source "https://rubygems.org"
+source 'https://rubygems.org'
 
 # Bundle edge Rails instead: gem "rails", github: "rails/rails", branch: "main"
-gem "rails", "~> 8.0.3"
+gem 'rails', '~> 8.0.3'
 # The modern asset pipeline for Rails [https://github.com/rails/propshaft]
-gem "propshaft"
+gem 'propshaft'
 # Use postgresql as the database for Active Record
-gem "pg", "~> 1.1"
+gem 'pg', '~> 1.1'
 # Use the Puma web server [https://github.com/puma/puma]
-gem "puma", ">= 5.0"
+gem 'puma', '>= 5.0'
 # Build JSON APIs with ease [https://github.com/rails/jbuilder]
-gem "jbuilder"
+gem 'jbuilder'
 
 # Use Active Model has_secure_password [https://guides.rubyonrails.org/active_model_basics.html#securepassword]
 # gem "bcrypt", "~> 3.1.7"
 
 # Windows does not include zoneinfo files, so bundle the tzinfo-data gem
-gem "tzinfo-data", platforms: %i[windows jruby]
+gem 'tzinfo-data', platforms: %i[windows jruby]
 
 # Reduces boot times through caching; required in config/boot.rb
-gem "bootsnap", require: false
+gem 'bootsnap', require: false
 
 # Add HTTP asset caching/compression and X-Sendfile acceleration to Puma [https://github.com/basecamp/thruster/]
-gem "thruster", require: false
+gem 'thruster', require: false
 
 group :development, :test do
   # See https://guides.rubyonrails.org/debugging_rails_applications.html#debugging-with-the-debug-gem
-  gem "debug", platforms: %i[mri windows], require: "debug/prelude"
+  gem 'debug', platforms: %i[mri windows], require: 'debug/prelude'
 
   # Static analysis for security vulnerabilities [https://brakemanscanner.org/]
-  gem "brakeman", require: false
+  gem 'brakeman', require: false
 
   # Omakase Ruby styling [https://github.com/rails/rubocop-rails-omakase/]
-  gem "rubocop-rails-omakase", require: false
+  gem 'rubocop-rails-omakase', require: false
 end
 
 group :development do
   # Use console on exceptions pages [https://github.com/rails/web-console]
-  gem "web-console"
+  gem 'web-console'
 end
 
-gem "shakapacker", "~> 9.3.0.beta.5"
+gem 'shakapacker', '~> 9.3.0'
 
-gem "react_on_rails", "~> 16.1"
+gem 'react_on_rails', '~> 16.1'
 
 # Shared demo configuration and utilities
-gem "shakacode_demo_common", path: "../../packages/shakacode_demo_common"
+gem 'shakacode_demo_common', path: '../../packages/shakacode_demo_common'