diff --git a/README.md b/README.md
index ff3965c..e831752 100644
--- a/README.md
+++ b/README.md
@@ -44,7 +44,7 @@ ReActionView.configure do |config|
   # config.intercept_erb = true
 
   # Enable debug mode
-  config.debug_mode = Rails.env.development?
+  config.debug_mode = Rails.env.development? && !ENV["REACTIONVIEW_DISABLE_DEBUG_MODE"]
 end
 ```
 
diff --git a/docs/docs/guides/debug-mode.md b/docs/docs/guides/debug-mode.md
index e7d064f..2d77f6b 100644
--- a/docs/docs/guides/debug-mode.md
+++ b/docs/docs/guides/debug-mode.md
@@ -19,7 +19,7 @@ Debug mode is enabled by default in development environments:
 :::code-group
 ```ruby [config/initializers/reactionview.rb]
 ReActionView.configure do |config|
-  config.debug_mode = Rails.env.development?
+  config.debug_mode = Rails.env.development? && !ENV["REACTIONVIEW_DISABLE_DEBUG_MODE"]
 end
 ```
 :::
diff --git a/docs/docs/installation.md b/docs/docs/installation.md
index 50c58fd..1768395 100644
--- a/docs/docs/installation.md
+++ b/docs/docs/installation.md
@@ -41,7 +41,7 @@ ReActionView.configure do |config|
   # config.intercept_erb = true
 
   # Enable debug mode in development (adds debug attributes to HTML)
-  config.debug_mode = Rails.env.development?
+  config.debug_mode = Rails.env.development? && !ENV["REACTIONVIEW_DISABLE_DEBUG_MODE"]
 end
 ```
 :::
@@ -60,7 +60,7 @@ To process **all** existing `.html.erb` templates through the Herb engine, enabl
 ```ruby [config/initializers/reactionview.rb]
 ReActionView.configure do |config|
   config.intercept_erb = true
-  config.debug_mode = Rails.env.development?
+  config.debug_mode = Rails.env.development? && !ENV["REACTIONVIEW_DISABLE_DEBUG_MODE"]
 end
 ```
 :::
diff --git a/lib/generators/reactionview/install_generator.rb b/lib/generators/reactionview/install_generator.rb
index fcd4154..fa70cac 100644
--- a/lib/generators/reactionview/install_generator.rb
+++ b/lib/generators/reactionview/install_generator.rb
@@ -21,7 +21,7 @@ def create_initializer
             # config.intercept_erb = true
 
             # Enable debug mode in development (adds debug attributes to HTML)
-            config.debug_mode = Rails.env.development?
+            config.debug_mode = Rails.env.development? && !ENV["REACTIONVIEW_DISABLE_DEBUG_MODE"]
 
             # Add custom transform visitors to process templates before compilation
             # config.transform_visitors = [