Skip to content

Commit 52cd0da

Browse files
authored
Merge pull request #456 from eqxDev/patch-1
Added Cloudflare troubleshooting information
2 parents c500ea2 + 4ef0b39 commit 52cd0da

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed

troubleshooting.blade.php

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,9 @@
88
* [Root Element Issues](#root-element-issues)
99
* [Symptoms](#root-element-symptoms)
1010
* [Cures](#root-element-cures)
11+
* [Cloudflare Compatibility Issues](#cloudflare-compatibility-issues)
12+
* [Symptoms](#cloudflare-symptoms)
13+
* [Cures](#cloudflare-cures)
1114

1215

1316
## Dom Diffing Issues {#dom-diffing-issues}
@@ -147,3 +150,15 @@ class HelloWorld extends Component
147150
@endcomponent
148151

149152
Another cause can be using __construct() inside the Livewire class or a Trait.
153+
154+
## Cloudflare Compatibility Issues {#cloudflare-compatibility-issues}
155+
156+
When using Livewire in a production environment, you might encounter issues that stem from Cloudflare's Rocket Loader and HTML minification features. These issues can manifest as the page becoming unresponsive or errors indicating that a component is not found.
157+
158+
### Symptoms {#cloudflare-symptoms}
159+
* Page becomes unresponsive after using `wire:navigate`.
160+
* Errors like "Component not found: {component_ID}".
161+
162+
### Cures {#cloudflare-cures}
163+
* **Disable Rocket Loader:** Go to your Cloudflare dashboard, navigate to the "Speed" section, and turn off Rocket Loader. This feature can interfere with the execution order of JavaScript, which is crucial for Livewire's operation.
164+
* **Disable HTML Minification:** In the Cloudflare dashboard under the "Optimization" section, turn off HTML minification. This will prevent alteration or minification of Livewire's inline scripts, which can lead to operational errors.

0 commit comments

Comments
 (0)