Skip to content

Commit d3583d7

Browse files
authored
Add Troubleshooting section to readme.md (#304)
1 parent b677bae commit d3583d7

File tree

1 file changed

+12
-1
lines changed

1 file changed

+12
-1
lines changed

sample-applications/blazing-coffee/readme.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ This is the repository of the Blazor Coffee Warehouse sample project which conta
99
* [Blazor Demo Features](#blazor-demo-features)
1010
* [Requirements](#requirements)
1111
* [Running the sample Blazor project](#running-the-sample-blazor-project)
12+
* [Troubleshooting](#troubleshooting)
1213
* [Licensing](#licensing)
1314
* [Setup with Telerik UI for Blazor Commercial](#setup-with-telerik-ui-for-blazor-commercial)
1415
* [Where can I find help?](#where-can-i-find-help)
@@ -85,7 +86,17 @@ The current demo app includes examples of the following features in the Blazor W
8586

8687
* Open the solution file in VS 2022 and, if not already, set the `BlazingCoffee.Server` project as a Startup project.
8788
* Hit Ctrl + F5.
88-
* If you receive a 404 error about missing `/_framework/blazor-hotreload.js`, then disable Hot Reload in the Visual Studio settings: Debugging > General and Debugging > .NET.
89+
90+
## Troubleshooting
91+
92+
If you see a never-ending loader on the home screen, check the browser console for errors. You may see a 404 error about a missing `/_framework/blazor-hotreload.js`. In this case, disable Hot Reload in the Visual Studio settings:
93+
94+
* **Debugging** > **General** and also in
95+
* **Debugging** > **.NET**.
96+
97+
Another option is to run the app through the **Kestrel** web server instead of **IIS Express** by selecting the `BlazingCoffee.Server` launch profile. This works even with enabled hot reload:
98+
99+
<img width="495" alt="Use the BlazingCoffee.Server launch profile to use the Kestrel web server" src="https://github.com/user-attachments/assets/2d7bd2f5-2145-435d-b57b-a8a1e26fd157">
89100

90101
## Licensing
91102

0 commit comments

Comments
 (0)