Add configurable project_path option

- Add config.project_path setting with Rails.root.to_s fallback
- Use configured path in debug visitor, meta tags, and template checking
- Useful for Docker mounts and monorepo structures

💘 Generated with Crush

Assisted-by: Crush:claude-sonnet-4.5

Author: 0000marcell

USAGE.md

@@ -0,0 +1,41 @@
+# How to Use the `project_path` Configuration
+
+This feature allows you to configure a custom project path for ReActionView, which is useful when:
+- Your Rails application is mounted in a subdirectory
+- You're using Docker or containers with different mount paths
+- You need to customize the path used for opening files in your editor
+
+## Configuration
+
+Add this to your `config/initializers/reactionview.rb`:
+
+```ruby
+ReActionView.configure do |config|
+  config.project_path = "/custom/path/to/project"
+end
+```
+
+## Behavior
+
+- **Default**: If not configured, it defaults to `Rails.root.to_s`
+- **Dev Tools**: The configured path is used in the `herb-project-path` meta tag for the browser dev tools
+- **Editor Integration**: When clicking on source locations in the browser, files will be opened relative to this path
+- **Debug Visitor**: The debug visitor uses this path to resolve template identifiers
+
+## Example Use Cases
+
+### Docker with volume mounts
+```ruby
+# Your app is at /app in the container but /Users/you/myapp on your host
+ReActionView.configure do |config|
+  config.project_path = "/Users/you/myapp"
+end
+```
+
+### Monorepo structure
+```ruby
+# Your Rails app is in a subdirectory of a larger monorepo
+ReActionView.configure do |config|
+  config.project_path = File.expand_path("../../", Rails.root)
+end
+```

lib/reactionview/config.rb

@@ -5,12 +5,14 @@ class Config
     attr_accessor :intercept_erb
     attr_accessor :debug_mode
     attr_accessor :transform_visitors
+    attr_accessor :project_path
     attr_writer :validation_mode
 
     def initialize
       @intercept_erb = false
       @debug_mode = nil
       @transform_visitors = []
+      @project_path = nil
     end
 
     def validation_mode

lib/reactionview/template/handlers/herb.rb

@@ -14,13 +14,13 @@ def call(template, source)
           if ::ReActionView.config.debug_mode_enabled? && local_template?(template)
             visitors << ::Herb::Engine::DebugVisitor.new(
               file_path: template.identifier,
-              project_path: Rails.root.to_s
+              project_path: project_path
             )
           end
 
           config = {
             filename: template.identifier,
-            project_path: Rails.root.to_s,
+            project_path: project_path,
             validation_mode: ReActionView.config.validation_mode,
             content_for_head: reactionview_dev_tools_markup(template),
             visitors: visitors + ReActionView.config.transform_visitors,
@@ -40,7 +40,7 @@ def layout_template?(template)
         def local_template?(template)
           return true unless template.respond_to?(:identifier) && template.identifier
 
-          template.identifier.start_with?(Rails.root.to_s)
+          template.identifier.start_with?(project_path)
         end
 
         def active_support_editor
@@ -58,6 +58,10 @@ def editor_meta_tag
           %(<meta name="herb-default-editor" content="#{editor_name}">)
         end
 
+        def project_path
+          ::ReActionView.config.project_path || Rails.root.to_s
+        end
+
         def reactionview_dev_tools_markup(template)
           return nil unless layout_template?(template)
           return nil unless local_template?(template)
@@ -67,7 +71,7 @@ def reactionview_dev_tools_markup(template)
           if ::ReActionView.config.debug_mode_enabled?
             markup << <<~HTML
               <meta name="herb-debug-mode" content="true">
-              <meta name="herb-project-path" content="#{Rails.root}">
+              <meta name="herb-project-path" content="#{project_path}">
               #{editor_meta_tag}
 
               #{ActionController::Base.new.view_context.javascript_include_tag "reactionview-dev-tools.umd.js", defer: true}