More updates

Author: justin808

AI_AGENT_INSTRUCTIONS.md

@@ -21,7 +21,7 @@ rails new myapp --skip-javascript --database=postgresql
 cd myapp
 
 # Use latest version
-bundle add react_on_rails --version 16.0.1 --strict
+bundle add react_on_rails --strict
 
 bin/rails generate react_on_rails:install
 
@@ -40,7 +40,7 @@ bin/dev
 ```bash
 cd /path/to/existing/app
 # Use latest version
-bundle add react_on_rails --version 16.0.1 --strict
+bundle add react_on_rails --strict
 
 bin/rails generate react_on_rails:install
 
@@ -58,6 +58,6 @@ bin/dev
 
 ## 🛠️ Common Troubleshooting Commands
 
-- Always run `bin/dev` to test setup, and check browser console for any JavaScript errors.\*
+- Always run `bin/dev` to test setup, and check browser console for any JavaScript errors
 - `bin/dev kill` stops other conflicting processes
 - `bin/rake react_on_rails:doctor` for helpful information

docs/README.md

@@ -8,7 +8,7 @@ New to React on Rails? Start here for the fastest path to success:
 
 **→ [15-Minute Quick Start Guide](./quick-start/README.md)**
 
-Already have Rails + Shakapacker? **→ [Add React on Rails in 5 minutes](./quick-start/existing-app.md)**
+Already have Rails + Shakapacker? **→ [Add to existing app guide](./guides/installation-into-an-existing-rails-app.md)**
 
 ## 📚 Learning Paths
 
@@ -40,14 +40,14 @@ Jump to what you need
 
 Find guidance for your specific scenario:
 
-| I want to...                        | Go here                                                 |
-| ----------------------------------- | ------------------------------------------------------- |
-| **Add React to existing Rails app** | [Installation Guide](./guides/installation.md)          |
-| **Enable server-side rendering**    | [SSR Guide](./guides/fundamentals/server-rendering.md)  |
-| **Set up hot reloading**            | [HMR Setup](./guides/development/hot-reloading.md)      |
-| **Use Redux with Rails**            | [Redux Integration](./guides/state-management/redux.md) |
-| **Deploy to production**            | [Deployment Guide](./guides/deployment/README.md)       |
-| **Troubleshoot issues**             | [Troubleshooting](./troubleshooting/README.md)          |
+| I want to...                        | Go here                                                                    |
+| ----------------------------------- | -------------------------------------------------------------------------- |
+| **Add React to existing Rails app** | [Installation Guide](./guides/installation-into-an-existing-rails-app.md)  |
+| **Enable server-side rendering**    | [SSR Guide](./guides/react-server-rendering.md)                            |
+| **Set up hot reloading**            | [HMR Setup](./guides/hmr-and-hot-reloading-with-the-webpack-dev-server.md) |
+| **Use Redux with Rails**            | [Redux Integration](./javascript/react-and-redux.md)                       |
+| **Deploy to production**            | [Deployment Guide](./guides/deployment.md)                                 |
+| **Troubleshoot issues**             | [Troubleshooting](./troubleshooting/README.md)                             |
 
 ## 📖 Complete Documentation
 
@@ -60,21 +60,21 @@ Find guidance for your specific scenario:
 
 ### Features
 
-- **[Server-Side Rendering](./guides/fundamentals/server-rendering.md)** - SSR setup and optimization
+- **[Server-Side Rendering](./guides/react-server-rendering.md)** - SSR setup and optimization
 - **[Auto-Bundling](./guides/auto-bundling-file-system-based-automated-bundle-generation.md)** - Automatic bundle generation
-- **[Redux Integration](./guides/state-management/redux.md)** - State management with Redux
-- **[React Router](./guides/routing/react-router.md)** - Client-side routing
+- **[Redux Integration](./javascript/react-and-redux.md)** - State management with Redux
+- **[React Router](./javascript/react-router.md)** - Client-side routing
 - **[Internationalization](./guides/i18n.md)** - I18n support
 
 ### Development
 
-- **[Hot Module Replacement](./guides/development/hot-reloading.md)** - Fast development workflow
+- **[Hot Module Replacement](./guides/hmr-and-hot-reloading-with-the-webpack-dev-server.md)** - Fast development workflow
 - **[Testing](./guides/development/testing.md)** - Testing React components
 - **[Debugging](./guides/development/debugging.md)** - Common debugging techniques
 
 ### Deployment & Performance
 
-- **[Deployment](./guides/deployment/README.md)** - Production deployment guide
+- **[Deployment](./guides/deployment.md)** - Production deployment guide
 - **[Performance](./guides/performance/README.md)** - Optimization techniques
 - **[Bundle Optimization](./guides/performance/webpack-bundle-optimization.md)** - Reduce bundle size
 

docs/api/README.md

@@ -0,0 +1,7 @@
+# API Reference
+
+Complete API documentation for React on Rails.
+
+- [View Helpers API](./view-helpers-api.md)
+- [Redux Store API](./redux-store-api.md)
+- [JavaScript API](./javascript-api.md)

docs/getting-started.md

@@ -61,11 +61,8 @@ cd PROJECT_NAME
 
 2. Run the install generator:
 
-   ``bash
+   ```bash
    bundle exec rails generate react_on_rails:install
-
-   ```
-
    ```
 
 Start the app:
@@ -137,11 +134,11 @@ With `auto_load_bundle: true`, and by placing your "exposed" components in the a
 - Automatically registers it for use.
 - Eliminates the need for manual pack configuration.
 
-See [Auto-Bundling: File-System-Based Automated Bundle Generation][./guides/auto-bundling-file-system-based-automated-bundle-generation.md]
+See [Auto-Bundling: File-System-Based Automated Bundle Generation](./guides/auto-bundling-file-system-based-automated-bundle-generation.md)
 
 Exposing your component in this way allows you to reference the component from a Rails view. You can expose as many components as you like, but their names must be unique. See below for the details of how you expose your components via the React on Rails Webpack configuration. You may call `ReactOnRails.register` many times.
 
-- `@some_props` can be either a hash or JSON string. This is an optional argument assuming you do not need to pass any options (if you want to pass options, such as `prerender: true`, but you do not want to pass any properties, simply pass an empty hash `{}`). This will make the data available in your component:
+- `@some_props` can be either a hash or JSON string. This is an optional argument assuming you do not need to pass any options (if you want to pass options, such as `prerender: true`, but you do not want to pass any properties, simply pass an empty hash `{}`). **Props are automatically sanitized by React on Rails for security.** This will make the data available in your component:
 
 - This is what your HelloWorld.js file might contain. The railsContext is always available for any parameters that you _always_ want available for your React components. It has _nothing_ to do with the concept of the [React Context](https://react.dev/reference/react/useContext). See [Render-Functions and the RailsContext](./guides/render-functions-and-railscontext.md) for more details on this topic.
 

docs/guides/advanced/README.md

@@ -0,0 +1,7 @@
+# Advanced Features
+
+Advanced React on Rails features and patterns.
+
+- [Auto-Bundling](../auto-bundling-file-system-based-automated-bundle-generation.md)
+- [Server-Side Rendering](../react-server-rendering.md)
+- [Performance Optimization](../webpack-configuration.md)

docs/guides/tutorial.md

@@ -22,7 +22,7 @@ By the time you read this, the latest may have changed. Be sure to check the ver
 - [https://rubygems.org/gems/react_on_rails](https://rubygems.org/gems/react_on_rails)
 - [https://www.npmjs.com/package/react-on-rails](https://www.npmjs.com/package/react-on-rails)
 
-# Table of Content
+# Table of Contents
 
 - [Installation](#installation)
   - [Setting up your environment](#setting-up-your-environment)

docs/quick-start/README.md

@@ -15,7 +15,7 @@ Before starting, make sure you have:
 
 > 💡 **Don't have a Rails app?** Run `rails new my_react_app` first.
 
-## 📦 Step 2: Install React on Rails (3 minutes)
+## 📦 Step 1: Install React on Rails (3 minutes)
 
 Add the React on Rails gem and run its installer:
 
@@ -38,7 +38,7 @@ Take a look at the files created by the generator.
 - A sample controller and view
 - Webpack configuration
 
-## 🎯 Step 3: Start the Development Server (1 minute)
+## 🎯 Step 2: Start the Development Server (1 minute)
 
 Start both Rails and the Webpack dev server:
 
@@ -51,7 +51,7 @@ This starts both:
 - Rails server on `http://localhost:3000`
 - Webpack dev server for hot reloading
 
-## 🎨 Step 4: See Your Component (2 minutes)
+## 🎨 Step 3: See Your Component (2 minutes)
 
 Open your browser and navigate to:
 
@@ -63,7 +63,7 @@ You should see a page with a React component saying "Hello World"!
 
 🎉 **Congratulations!** You have React running in your Rails app.
 
-## 🔧 Step 5: Edit Your Component (2 minutes)
+## 🔧 Step 4: Edit Your Component (2 minutes)
 
 Let's make a quick change to see hot reloading in action:
 
@@ -72,15 +72,15 @@ Let's make a quick change to see hot reloading in action:
 3. Save the file
 4. Watch your browser automatically refresh
 
-## 🚀 Step 6: Add Components to Existing Views (5 minutes)
+## 🚀 Step 5: Add Components to Existing Views (5 minutes)
 
 Now let's add a React component to one of your existing Rails views:
 
 ### Create a New Component
 
 ```bash
 # Create a new component directory
-mkdir -p app/javacript/src/SimpleCounter/components
+mkdir -p app/javascript/src/SimpleCounter/ror_components
 
 # Create the component file
 touch app/javascript/src/SimpleCounter/ror_components/SimpleCounter.jsx